文档教程

欢迎使用 Zettlr！本教程将帮助您从安装到精通，快速掌握这款专为学术写作设计的 Markdown 编辑器。

快速入门

安装 Zettlr 非常简单。访问下载中心，选择适合您操作系统的安装包，双击运行安装向导即可。

第一步：设置语言

打开首选项（Preferences）→ General → Application Language，找到 Chinese（中文），联网下载语言包后重启软件即可切换为中文界面。

第二步：创建工作区

点击左侧文件管理器顶部的「打开文件夹」按钮，选择您存放笔记的目录。Zettlr 会将其作为工作区加载，您可以在其中创建、编辑和管理 Markdown 文件。

第三步：开始写作

点击工具栏的「新建文件」按钮，或使用快捷键 Ctrl+N（macOS 为 Cmd+N）创建新文档。Zettlr 使用标准 Markdown 语法，同时支持 Pandoc 扩展。

界面导览

Zettlr 的界面分为三个主要区域：

• 左侧边栏：文件管理器，显示工作区目录结构，支持文件夹展开/收起、文件搜索与筛选。
• 中间编辑区：Markdown 编辑器，支持实时预览、分屏模式与专注模式切换。
• 右侧边栏：显示当前文档的引用、标签、目录大纲与相关信息。

视图模式切换

通过工具栏或快捷键可在以下模式间切换：

• 编辑模式：纯 Markdown 源码编辑
• 预览模式：渲染后的阅读视图
• 分屏模式：左侧编辑、右侧预览（快捷键 Ctrl+\）
• 专注模式：隐藏干扰元素，仅保留编辑器（快捷键 Ctrl+J）
• 打字机模式：光标始终保持在屏幕中央

Zettelkasten 笔记法

Zettlr 的名字来源于德语「Zettel」（卡片）与「kasten」（盒子），其核心设计哲学正是 Zettelkasten（卡片盒笔记法）。

创建双向链接

在文档中使用 [[笔记标题]] 语法即可创建指向另一篇笔记的链接。Zettlr 会自动：

• 建立双向关联，在被引用的笔记中显示反向链接
• 在知识图谱中可视化呈现笔记间的连接关系
• 支持通过 Ctrl+点击 快速跳转

使用标签分类

在文档任意位置使用 #标签名 即可为笔记添加标签。标签管理器支持：

• 为不同标签分配颜色，实现可视化分类
• 点击标签快速筛选相关笔记
• 查看标签云与使用统计

文件标识（ID）

Zettlr 支持多种文件标识方式，包括时间戳 ID（如 20260726172500）与自定义 ID。在链接中使用 ID 而非标题，可避免笔记重命名导致链接失效。

引文管理配置

Zettlr 的引文管理功能是其区别于普通 Markdown 编辑器的核心优势之一。

配置 Zotero 集成

1. 确保已安装 Zotero 并启用「Better BibTeX」插件
2. 在 Zotero 中导出文献库为 CSL JSON 或 BibTeX 格式
3. 打开 Zettlr 首选项 → 引文 → 引文库，加载导出的文献文件
4. 在编辑器中输入 [@ 即可唤起引文选择器

插入引文

在需要插入引文的位置输入 [@作者年份]，例如 [@Zelizer2004]。Zettlr 会自动：

• 在文档中显示格式化的引文标注
• 在右侧边栏显示参考文献列表预览
• 导出时自动生成完整的参考文献列表

导出与出版

Zettlr 内置 Pandoc 引擎，支持将 Markdown 文档导出为多种专业格式。

基础导出

点击工具栏的「导出」按钮，或按下 Ctrl+E，选择目标格式即可。支持的格式包括：

• PDF：通过 LaTeX 或内置引擎生成，适合论文投稿
• Microsoft Word (.docx)：保留标题样式与格式，便于协作编辑
• HTML：适合网页发布与博客导入
• LaTeX：保留完整排版指令，适合期刊投稿
• ODT / RTF：兼容多种文字处理软件
• Reveal.js 幻灯片：将 Markdown 转为演示文稿

使用自定义模板

在首选项 → 导出 中，您可以配置自定义的 LaTeX 或 Word 模板，以适配特定期刊或学校的格式要求。模板支持变量替换，可自动插入标题、作者、日期等元数据。

界面自定义

Zettlr 提供丰富的自定义选项，让您打造最舒适的写作环境。

主题与外观

• 首选项 → 外观 → 主题：切换明暗主题与配色方案
• 首选项 → 外观 → 自定义 CSS：完全控制界面样式
• 编辑器设置：调整字体、字号、行高与缩进

代码片段（Snippets）

在首选项 → 代码片段中，您可以定义缩写与对应的展开文本。例如设置 zettlr 展开为「Zettlr — 您的一站式出版工作台」，大幅提升重复内容的输入效率。

常见问题

Zettlr 是免费的吗？

是的，Zettlr 是一款完全开源、永久免费的软件，遵循 GNU GPL v3 许可证。您无需支付任何费用即可使用全部功能。

如何同步笔记到多台设备？

Zettlr 以纯 Markdown 文件存储数据，您可以使用任意云同步服务（如 Dropbox、OneDrive、坚果云）或 Git 进行跨设备同步，完全不受限制。

支持移动端吗？

目前 Zettlr 专注于桌面端体验，暂不提供移动端应用。但您的 Markdown 文件可在任何支持 Markdown 的移动端应用中打开和编辑。

如何报告问题或提出建议？

欢迎通过GitHub Issues 提交 Bug 报告，或加入 Discord 社区 与其他用户交流。