Snippets 代码片段与自定义模板——写一次、到处插

什么是 Snippets

Snippets（代码片段）是一段可复用的文本。在编辑器里把光标移到要插入的位置，点底部操作栏的 Snippets 按钮，从弹出列表里选一个，Markor 就把那段文本插到光标处。

这对以下场景特别有用：

• 每天写会议纪要，开头格式固定（日期 + 参会人 + 议程）
• 写技术文档，经常需要插入相同的代码块模板
• 在 todo.txt 里定期批量添加同格式的任务

Snippets 存放位置

所有 Snippets 文本文件放在 Notebook 根目录下的隐藏目录：

<Notebook 根目录>/.app/snippets/

• 首次点 Snippets 按钮时，Markor 会 自动创建这个目录（如果不存在）
• 文件名就是 Snippets 的名字（比如 meeting-header.md 在列表里显示为 meeting-header）
• 可以用 Markdown、纯文本、AsciiDoc、Org-Mode 等 任意格式

手动创建第一个 Snippet

1. 点 Markor 文件浏览器底部操作栏的 Snippets 按钮
2. 弹窗提示目录不存在 → 自动创建
3. 用文件管理器或 Markor 打开 .app/snippets/ 目录
4. 新建一个 .md 文件，比如 meeting-template.md
5. 写入内容：

## 会议纪要

**日期**：
**地点**：
**参会人**：

### 议程

### 讨论要点

### 决议

### 后续行动
- 

1. 保存。现在这个 Snippet 就出现在 Snippets 列表里了。

在编辑器里插入 Snippet

1. 打开任意文件（Markdown / AsciiDoc / Org-Mode 等）
2. 光标移到要插入 Snippet 的位置
3. 点底部操作栏的 Snippets 按钮（📋 图标，v2.9 新增）
4. 从列表里选刚才创建的 meeting-template
5. 这段内容就插到光标位置了

v2.10 扩展：新建文件时用模板

v2.10 把 Snippets 系统扩展到了 新建文件 场景：

1. 打开文件浏览器，点加号新建文件
2. 选格式（比如 Markdown），输入文件名
3. 在新建对话框底部可以选一个 Snippet 作为 模板
4. 新建的文件直接包含该 Snippet 的内容

这意味着你可以：

• 用同一个 Snippet 既当模板新建文件、又能在已有文件里插入
• 一次编写、两处复用

推荐的 Snippets 清单

Snippets 和同步客户端的关系

.app/snippets/ 目录是 Markor 自己的 隐藏目录（以 . 开头）：

• 默认同步客户端（Syncthing、Dropbox、Nextcloud）通常会忽略以点开头的目录
• 如果你希望 Snippets 在手机和桌面端同步，需要在同步客户端里 显式添加 .app/ 目录 到同步白名单
• 另一个做法：把 Snippets 放在 Notebook 根目录下的非隐藏子目录（比如 snippets/），Markor 会自动扫描这个目录（v2.10+ 支持）

和 Obsidian Snippets 的关系

Markor 的 Snippets 系统和 Obsidian 的 代码片段功能 概念类似，但：

如果你同时用 Markor（Android）和 Obsidian（桌面），两边各自维护 Snippets 即可——格式相同、互不影响。

自定义文件模板（v2.10）

v2.10 新增的 Snippets 系统已经足够灵活，Markor 还在设置里提供了 Markor-markdown-reference.md 这个内置模板——它展示了 Markor 支持的所有 Markdown 格式，可以在新建 Markdown 文件时选作模板，作为格式参考。