跳转到正文

片段库

设置 → 片段库用于管理本机全局的 Math、Mermaid、Code 源码片段。编辑器菜单中的“管理片段”可以直接打开对应分类。

类型 内置示例 填写内容
Math 分式 公式源码,不含外层 $$。
Mermaid 流程图 图表源码,不含 Markdown 代码围栏。
Code JSON 代码源码,不含围栏;语言单独选择。

创建和管理

内置片段可隐藏、恢复或复制为自定义片段。自定义片段支持名称搜索、新建、编辑、复制和删除。保存会保留源码的缩进、Tab 和首尾换行;${…} 按文字处理。

修改先保留为草稿,点击“保存”后才写入片段库。离开条目、切换设置页或关闭管理窗口时,可以保存、放弃或取消。点击“预览”可查看片段效果;源码修改后需要重新预览,预览失败不阻止保存。

插入文档

在所见即所得编辑器中输入 /,用鼠标或上下方向键选中 Math、Mermaid 或 Code 时,会展开片段子菜单,键盘焦点仍留在当前分类。直接按 Enter 会插入空白块,并自动聚焦源码编辑区;按右方向键后才能用上下方向键选择子菜单条目,也可以直接点击片段插入。左方向键返回分类,Escape 逐级关闭,取消和管理片段均保留 /。块工具栏右侧的片段按钮会替换先前的源码选区,或在光标处插入;没有有效位置时在源码末尾插入。已有代码块保留语言,新建代码块采用片段语言。一次插入可一次撤销。

保存与多窗口使用

片段库保存在应用数据目录的 snippets.json,可在不同工作区中复用。保存后,其他窗口也会更新。如果同一片段已被另一个窗口修改,当前草稿会保留并提示冲突。先复制需要保留的内容,再放弃草稿并重新打开条目,载入最新版本后继续编辑。