帮助中心

安装与启动

YiziMarkdown 提供三种分发形式，按需选择：

界面总览

• 标签栏：多文件管理，像浏览器一样切换。右侧可切换演示模式与视图。
• 工具栏：格式化、表格、代码块、公式、图表、模板、导出、AI 助手入口。
• 侧边栏：自动生成的文档大纲，点击跳转（Ctrl+\ 开关）。
• 编辑区：基于 CodeMirror 6，支持实时预览与标记隐藏。
• 状态栏：字数、行列、视图模式、保存状态。
• AI 面板：右侧抽屉，与大模型对话并调用技能。

5 分钟上手路径

1. 按 Ctrl+N 新建文档，写几个标题与段落。
2. 按 F3 循环切换视图，找到最舒服的写作模式（推荐先试「实时模式」）。
3. 输入 / 唤出斜杠菜单，快速插入列表、表格、代码块。
4. 按 Ctrl+S 保存为 .md 文件。
5. 按 Ctrl+Alt+P，立刻把这篇笔记变成幻灯片。

基本操作

自动保存

在「设置 → 通用」开启，间隔可选 5~180 秒（默认 60 秒），仅在有未保存修改时触发。

导出（v0.2.4 新增 Word / PDF）

工具栏右侧导出按钮支持五种格式：

• Word 文档（DOCX）：Word 原生语义（标题 / 列表 / 表格 / 代码块 / 引用 / 任务列表），表格与表头样式对齐预览；图片支持本地路径、网络图片与 HTML <img> 标签，可用 width 属性控制宽度
• PDF：与预览还原度一致，长文档自动分页（Windows）
• HTML（Ctrl+H）：保留主题样式，可直接分享或发布；导出的 HTML 自带左侧悬浮大纲卡片，点击条目直达对应章节（PDF 不含侧栏）
• Markdown（Ctrl+M）：纯 Markdown 文本副本
• 纯文本：去除所有标记符号

标签栏与首页

• 点击标签切换文件；双击或中键点击可关闭标签
• 按住标签拖动可调整顺序，带插入指示线与跟手浮层
• 未保存的文件标签上显示主题色呼吸圆点，保存成功后变勾号，1.5 秒后消失
• 关闭最后一个标签回到首页，展示最近打开的文件（名称、大小、修改时间）

单实例与文件关联

• 单实例：双击 .md 文件时不会开多个窗口，自动合并到已有实例并定位到该标签
• 文件关联：「设置 → 通用」一键设为系统默认 Markdown 编辑器，可随时取消

五种视图模式

切换视图时会自动定位到当前编辑位置；停在顶部时不作补偿，不会刚切过去就被动滚走。按 F3 可循环切换。

元信息属性面板（v0.3.2 新增）

文档开头的 YAML 元信息（--- 包裹）在三种模式下各有规范显示：

• 源码模式：原样显示，所见即文件
• 实时模式：渲染为可编辑属性面板 —— 每行 = [类型图标] [属性名] [值]，点类型图标可切换 7 种属性类型（自动 / 文本 / 数字 / 复选框 / 日期 / 日期和时间 / 列表），类型按属性名自动记忆
• 预览模式：隐藏（阅读模式主流做法）

面板表头的「编辑源码」可把光标落到第一个属性行，直接编辑原始 YAML。

实时模式动画

实时模式下 #、**、- 等标记会在光标进入时平滑显现，离开时隐藏。四种效果可选：

设置路径：设置 → 实时模式，可实时预览各方案效果。

工具栏格式化

选中文字后点击按钮即可应用。规则：粗体 / 斜体 / 删除线 / 行内代码会包裹选中内容；标题 / 列表 / 引用在行首添加前缀；链接 / 图片把选中文字填入显示文本。

斜杠菜单与自动补全

输入 / 或 、 唤出斜杠菜单（也可按 Ins），支持键盘上下选择、Enter 插入；继续输入字符会自动关闭。

编辑器还会在以下情况自动补全：输入 # / - / * / > 后按空格自动生成对应结构；输入 `、**、*、~~、[ 自动配对闭合。

搜索替换与大纲导航

• Ctrl+F 打开搜索栏，输入关键词高亮匹配，点箭头逐个跳转
• 输入替换内容后可「全部替换」
• 侧边栏自动根据标题层级生成大纲，点击跳转；并排模式下与预览双向联动滚动

标题折叠（v0.2.3 新增）

• 鼠标悬停标题时左侧出现折叠图标，点击折叠该标题下的内容
• 已折叠的标题常显展开图标，无需 hover
• 快捷键：Ctrl+Shift+[ 折叠，Ctrl+Shift+] 展开

划词助手（v0.2.3 新增）

选中文本后可用的操作：

• 演示稿：把选中内容提炼为演示文稿结构
• 摘要：提炼核心要点
• 改写 / 润色：优化表达，保持原意
• 翻译：翻译为目标语言
• 复制：复制到剪贴板
• 添加到 AI 对话：作为上下文送进右侧 AI 面板

Markdown 语法速查

表格

工具栏表格按钮或 Ctrl+T 打开 8×8 网格，鼠标移到目标位置点击即插入对应行列数的表格，无需手写分隔线。实时模式下表格渲染为真正的 HTML 表格，可点击单元格直接编辑。

代码块

• 集成 highlight.js 语法高亮，头部显示语言标签
• 右上角支持一键复制与自动换行切换
• 语言写在围栏后即可：```python、```rust 等

图片与链接

• 本地图片：支持 jpg / png / gif / webp / svg / bmp，路径需为绝对路径（如 C:\images\photo.png）
• 网络图片：http / https 开头的 URL 直接显示
• 插入对话框：图片支持网络 URL 与本地文件两种方式，本地文件走系统原生文件选择器
• 链接跳转：预览中点击链接会用系统默认浏览器打开，不在应用内导航

数学公式（KaTeX）

• 行内公式：用 $...$ 包裹，如 $E=mc^2$
• 块级公式：用 $$...$$ 独占一行，居中渲染为独立公式块
• 工具栏 Σ 按钮可把选中文字包裹为行内公式
• 在「设置 → 插件」中可开关 KaTeX 插件

Mermaid 图表

用代码描述即可生成可视化图表：

graph LR
    A[开始] --> B{判断}
    B -->|是| C[执行]
    B -->|否| D[跳过]

支持流程图（graph / flowchart）、时序图（sequenceDiagram）、甘特图（gantt）、类图（classDiagram）、饼图（pie）、状态图（stateDiagram）等。图表主题可在「设置 → 插件 → Mermaid 配置」切换（默认 / 深色 / 森林 / 中性）。

HTML 渲染

预览模式（整页与并排）可渲染原始 HTML，包括表格、行内样式等。实时模式下块级 HTML 及单独成行的行内元素会渲染为真实内容，光标落上去自动还原为源码以便编辑。

进入与退出

• 按 Ctrl+Alt+P，或点击标签栏 / 工具栏的「演示」按钮
• 进入后自动全屏，按 Esc 退出并返回编辑界面
• 鼠标活动时右上角显示半透明退出按钮，1.5 秒无操作自动隐藏
• 退出时自动还原进入前的窗口状态（全屏 / 最大化 / 普通）

分页规则

用单独成行的 ---（标准 Markdown 分割线）翻页：

# 第一页

---

# 第二页

• --- 必须单独成行（前后是空行）
• 代码围栏内部的 --- 属于代码内容，不会分页
• 文档顶部的 front matter（首个 --- ... --- 块）自动忽略，不会成为一页

片段逐步显示（默认关闭）

把一页内容拆成多步展示：→ 先逐条显示、走完再翻页；← 先逐条退回、退完再翻页。

• 生效版式：内容页 / 列表页 / 路线图页（目录页不分段）
• 整副开启：front matter 写 slideshow-fragments: on
• 单页开启：页面里写 <!-- fragments: on -->（off 可单页关闭）
• 临时开启：播放中点 HUD 的列表图标按钮，仅本次播放生效
• 优先级：页级注释 > HUD 开关 > front matter

默认关闭——多数场景整页显示更省心，需要控制节奏时再开。

14 种自动版式

引擎分析整页结构自动推断版式，无需任何标记：

12 种切换动画

播放中点 HUD 底部的 ✨ 图标选择，仅本次播放生效（不改文档）。

切换动画是「新页加载」模型：新页在上层入场、旧页静止在下层被覆盖。强烈型会把整页（含背景）切成单元，每个单元自带前后两页的内容各自独立变换——所以背景也一起动，不是只有文字在变。

动画方案按平台分别优化：Windows 与 macOS（WebKit）各走一套经过实测调校的参数；翻面黑块、阴影丢失、溶解失效、亮色下叶片发黑等问题已在 macOS 侧修掉，棋盘格子与六角蜂巢在 macOS 使用小格闪烁效果。选择的动画会被记住。

显式指令与装饰

• <!-- layout: quote --> 强制指定版式
• <!-- align: left|center|right --> 指定整页对齐
• 左下角显示章节名 + 页码页脚，底部主题色进度条随翻页增长
• 配色继承当前主题与明暗，标题颜色随主题变化——换主题，幻灯片同步换肤
• 滚轮翻页：内容可滚动时先滚动内容，到上/下边界再翻页；翻页后短暂锁定防惯性连翻

演讲者备注

在幻灯片任意位置用 HTML 注释写备注，播放时按 S 显示 / 隐藏：

<!-- notes: 这一页要强调的重点 -->

备注只显示在左下角面板，不会出现在正片画面。

播放快捷键

配置步骤

1. 打开「设置 → AI」
2. 选择供应商（内置 18 家，或选「自定义服务」）
3. 填入 API 密钥，点击「验证」确认连通
4. 回到主界面，点击工具栏机器人图标打开 AI 面板即可对话

内置供应商

共 18 家 + 自定义服务 = 19 个选项，覆盖国内外主流与本地模型：

密钥安全

API 密钥保存在系统钥匙串（macOS Keychain / Windows 凭据管理器），绝不写入设置文件、不上传网络。设置页可一键保存、清除、验证。

对话能力

• 流式回复：回答实时输出，可随时停止生成
• 思考过程：DeepSeek / Qwen / GLM / Anthropic 等推理模型的 reasoning 以可折叠区块展示（默认收起）
• 引用当前文档：勾选后把当前文档作为上下文发送；可在「设置 → AI」调整引用上限（64K~512K / 不限）
• 上下文轮数：可配置 0~20 轮历史携带
• 结果落盘：每条回复下方有「复制」「插入到文档（光标处）」「创建新文档」三个操作
• 面板状态持久化：面板开关与待执行动作会被记住，关闭后重开保持状态

内置技能

调用步骤

1. 点击输入框上方的 ⚡ 闪电按钮，弹出技能菜单（鼠标悬停可展开详细介绍）
2. 点击选中一个技能，会以胶囊标签插入输入框光标处，与文字混排
3. 直接输入内容并发送（也可不输入文字直接发送），技能提示词自动注入 AI 上下文
4. 取消技能：把光标移到标签上退格删除，或悬停标签点击出现的 ✕
5. 带 ⚡ 的技能（如「演示稿提炼」）会自动勾选并锁定「引用当前文档」，删除技能后恢复手动勾选

自定义技能

AI 面板底部的「管理技能」按钮可直接打开技能目录并查看 skill-guide.md 定制指南。新增技能只需两步：

1. 在技能目录放入技能的 Markdown 提示词文件，例如 my-skill.md
2. 在 skills.json 清单中登记（见下表字段），保存后重启软件

内置技能也会同步到该目录，可以基于内置技能修改提示词来创建自己的版本。首次启动新版本时自动同步。

配置服务器

打开「设置 → 云端存储」：

浏览云端文件

• 侧边栏切换到「云端」标签页，点击文件夹进入；层级较深时顶部面包屑把上级折成 …，点 … 可下拉跳转任意隐藏层级
• 点文件夹图标可就地逐层展开子目录（懒加载），带层级引导线，不必来回进出
• 点击文档直接打开；正文与文档中相对引用的图片会一并下载到本地缓存
• 悬停行尾的 ⋯ 或右键，可新建文件夹 / 重命名 / 删除（删除不可撤销，删文件夹会一并删除其中内容）
• 右上角 ⟳ 手动刷新；保存到云端后若正浏览该目录，列表会自动刷新

保存到云端

• 上传本地文档：点工具栏「保存到云端」，确认云端路径后上传；文档中相对引用的图片会一并上传并保持目录结构
• 保存云端文档：直接 Ctrl+S，写回它原本的远程位置
• 另存到其他云端位置：同样是「保存到云端」，把路径改成新的即可

保存云端文档时是「先写本地缓存、再上传服务器」，两步都成功才会标记为已保存；任一步失败都会保持未保存状态并提示。

冲突保护

打开云端文档时会记录服务器的 ETag。若保存前发现该文件已被其他设备修改，会弹窗让你选择：

• 覆盖服务器版本：用本地内容覆盖服务器
• 放弃本地修改并重新加载：丢弃本地编辑，重新拉取服务器版本

注意事项

• 需要服务端支持 WebDAV。若提示需要 Digest 认证，请改用应用专用密码（本程序只支持 Basic 认证）
• 只有相对路径的图片会随文档同步；绝对路径（D:\pics\a.png、/home/me/a.png）、file://、网络图片与 data: 都不会上传
• 云端文档在本地保留一份缓存（~/Documents/yizimarkdown/webdav/）用于图片渲染与导出；删除它不影响云端数据，下次打开会自动重新下载

主题一览

液态玻璃 Prism（默认）

学术蓝

活力橙

科技感

极简风

杂志感

自然风

荔枝红

紫罗兰

赛博朋克

Facebook

黑客帝国

薄荷冰沙

落日熔金

复古打字机

在「设置 → 外观」中可切换主题、编辑主题名称、查看色板预览。按 F2 可快速切换深色 / 亮色模式。

字体与排版

在「设置 → 编辑器」中，可分别为源码与预览模式设置字体、字号（12~32px）与行高（1.2~3.0）。支持搜索系统已安装字体，也可手动输入 CSS font-family。

自定义主题与 CSS

• 自定义主题：在程序目录 themes/ 放入 .css 文件，重启后自动识别。CSS 需用 .editor-content 前缀限定范围，避免影响设置面板
• 自定义 CSS：在「设置 → 外观 → 自定义 CSS」中编辑，或直接改程序目录 user.css。它加载在所有主题之后，优先级最高

每个设置面板底部都有「恢复默认」按钮，可单独还原该分类。

界面语言

支持 15 种：简体中文（默认）、繁體中文、English、日本語、한국어、Deutsch、Français、Español、Português、Italiano、Polski、Nederlands、Türkçe、Svenska、Українська。在「设置 → 通用 → 界面语言」切换，即时生效，无需重启。

文档模板

• 从模板新建：点击工具栏「新建」旁的「从模板新建」，下拉选择模板
• 默认模板：在「设置 → 通用 → 默认模板」指定后，Ctrl+N 自动套用该结构
• 模板管理：在「设置 → 模板」中新建、编辑模板；保存后工具栏菜单即时刷新，无需重启

模板存放在用户目录 ~/Documents/yizimarkdown/templates/，把 .md 文件放进去即可使用（v0.2.4 起，卸载 / 重装 / 升级都不会丢失）。

快捷键配置支持可视化面板、按键录制与冲突检测，改错了可一键恢复默认。配置文件保存在程序目录 keybindings.json。

macOS 打开时提示「无法验证开发者」，怎么办？

这是 Gatekeeper 对未公证应用的正常拦截。YiziMarkdown 采用 ad-hoc 签名免费分发，首次打开请：在「访达」中按住 Control 点击（或触控板双指轻点）应用图标 → 选择「打开」→ 再点一次「打开」。也可在终端执行 xattr -dr com.apple.quarantine /Applications/YiziMarkdown.app 解除隔离标记。

保存 AI 密钥时弹出「想要访问您的钥匙串」并要求密码授权，正常吗？

正常，这是 macOS 安全机制。密钥通过系统钥匙串加密存储，不写入设置文件、不上传网络。首次访问需输入 Mac 登录密码或使用 Touch ID，点击「始终允许」后不再提示。

AI 聊天需要付费吗？

软件免费开源。AI 调用费用由你选择的服务商收取；使用 Ollama 本地模型则完全免费、无需联网。

换电脑或重装系统后，文档和 AI 密钥会丢吗？

文档不会丢：内容就是标准 .md 文件，放任意位置都能打开。AI 密钥不迁移：它只存在本机钥匙串，需在新机器重新配置一次。

v0.2.3 技能目录迁移后，自定义技能怎么办？

技能文件已迁至 ~/Documents/yizimarkdown/skills/。已有的自定义技能只要放在该目录下即可继续使用；内置技能在首次启动新版本时自动同步过去。

v0.2.4 起文档模板存在哪里？卸载重装会丢吗？

文档模板也从应用目录迁至用户目录 ~/Documents/yizimarkdown/templates/，卸载、重装、升级都不会丢失。内置模板会在首次启动时自动同步到该目录，且只补齐缺失文件、不会覆盖你自己的模板；你也可以在「设置 → 模板」中直接新建或编辑。

添加的自定义主题没有出现？

确认文件放在程序目录 themes/ 下、扩展名为 .css，然后重启程序。CSS 内部记得用 .editor-content 前缀限定范围。

预览中的图片不显示怎么办？

本地图片支持 jpg / png / gif / webp / svg / bmp，路径需为绝对路径；网络图片以 http / https 开头即可正常显示。

关联 .md 文件后图标没变？

Windows 图标缓存可能延迟刷新，尝试重启资源管理器或重启电脑。

如何恢复默认设置？

在各设置面板底部点击「恢复默认」按钮，按分类还原。

数据存储在哪？

数据分七个层面存放：

1. 新建/未保存文件：在编辑器内存在 localStorage 缓存，下次打开软件时自动恢复、自动加载（不依赖系统文件路径，重启后仍在）
2. 配置文件（主题、自动保存参数、快捷键绑定等）：同样存在 localStorage 缓存中
3. API 密钥：保存在系统钥匙串（macOS Keychain / Windows 凭据管理器），不明文暴露、不上传网络——随时可在「设置 → AI」清除
4. 技能文件（v0.2.3 起）：从应用目录迁移至用户目录 ~/Documents/yizimarkdown/skills/，支持自定义，升级软件不会覆盖
5. 文档模板（v0.2.4 起）：与技能同理，存放在用户目录 ~/Documents/yizimarkdown/templates/，支持自定义，升级 / 卸载 / 重装不会丢失
6. WebDAV 凭据（v0.3.0 起）：与 API 密钥同理，保存在系统凭据库（Windows 凭据管理器 / macOS 钥匙串），不写入任何配置文件；随时可在「设置 → 云端存储」清除
7. 云端文档缓存（v0.3.0 起）：存放在 ~/Documents/yizimarkdown/webdav/，仅用于图片渲染与导出。它是派生物，删除不影响云端数据，下次打开会自动重新下载

云端文档改了会丢吗？多台设备同时改怎么办？

打开云端文档时会记录服务器的 ETag；保存前若发现文件已被其他设备修改，会弹窗让你选择「覆盖服务器版本」或「放弃本地修改并重新加载」，不会静默覆盖。自动保存遇到冲突会暂停并提示，按 Ctrl+S 手动处理。

为什么云端文档里的图片没有一起上传？

只有相对路径的图片（如 images/a.png、../assets/x.png）会随文档同步，并保持目录结构。绝对路径（D:\pics\a.png、/home/me/a.png）、file://、网络图片与 data: 都不会上传——这是为了避免把你本机其他位置的文件传到服务器。

云端测试连接提示「需要 Digest 认证」或用户名密码错误？

本程序只支持 Basic 认证，且多数 WebDAV 服务（坚果云、开启两步验证的 Nextcloud）不接受登录密码，必须使用应用专用密码：坚果云在「账户信息 → 安全选项 → 添加应用」生成，Nextcloud 在「设置 → 安全 → 应用密码」生成。另外请确认服务器地址包含完整路径，例如坚果云是 https://dav.jianguoyun.com/dav/（注意结尾的 /dav/）。

中文标点需要按两次？

已在 v0.1.2 修复，请升级到最新版本。

程序目录结构

YiziMarkdown/
├── YiziMarkdown.exe        # 主程序
├── readme.md               # 项目说明
├── help.md                 # 帮助文档（软件内可查看）
├── welcome.md              # 欢迎文档
├── changelog.md            # 开发日志
├── user.css                # 用户自定义样式（优先级最高）
├── keybindings.json        # 快捷键配置
├── md-icon.ico             # Markdown 文件关联图标
├── themes/                 # 主题 CSS（放入 .css 即可扩展）
├── templates/              # 内置模板（首启同步至用户目录）
└── skills/                 # 内置技能（首启同步至用户目录）

v0.2.3 起技能、v0.2.4 起文档模板的真实存储位置都在用户目录：~/Documents/yizimarkdown/skills/ 与 ~/Documents/yizimarkdown/templates/，自定义内容请放这里，升级 / 重装不会被覆盖。

获取帮助

• 软件内：按 F1 查快捷键，或打开 help.md
• GitHub Issues：提交 Bug 与功能建议
• Releases：查看与下载历史版本
• 更新记录见首页「更新」板块