Zettlr Markdown 编辑器教程

June 24, 2026 · View on GitHub

简介

Zettlr 是一款免费、开源的 Markdown 编辑器,专为学术写作、笔记记录和知识管理设计。它支持 Zettelkasten 方法论、引用管理,并可导出为多种格式,包括 PDF、DOCX 和 HTML。

特性描述
Markdown 编辑完整 Markdown 支持,带实时预览
Zettelkasten基于链接的知识管理系统
引用与 Zotero 和 BibTeX 集成
导出PDF、DOCX、HTML 和 LaTeX 导出
跨平台Windows、macOS 和 Linux

核心概念

Markdown 基础

语法结果
# 标题 1一级标题
## 标题 2二级标题
**bold**粗体文本
*italic*斜体文本
[link](url)超链接
![alt](image)图片
- item无序列表
1. item有序列表
`code`行内代码
```代码块
> quote引用块
---水平线

Zettelkasten 方法

概念描述
Zettel带唯一 ID 的独立笔记
链接相关笔记之间的连接
标签分类标签
结构笔记组织主题的索引笔记
Folgezettel顺序笔记链

安装

下载和安装

平台方法
Windows从 zettlr.com 下载安装程序
macOS下载 DMG 或使用 Homebrew:brew install --cask zettlr
Ubuntu/Debian从发布页面下载 .deb 包
Fedora下载 .rpm 包
Arch Linuxyay -S zettlr

系统要求

组件最低要求推荐配置
CPU64 位处理器多核
内存2 GB4 GB+
存储200 MB1 GB+
显示1280x7201920x1080+

界面概述

主布局

区域描述
文件管理器左侧栏,带文件树
编辑器主编辑区域,Markdown
预览右侧栏,带渲染预览
工具栏顶部工具栏,带格式按钮
状态栏底部栏,带文档统计

编辑器模式

模式描述
Default标准 Markdown 编辑
Minimal无干扰写作
Presentation幻灯片演示模式
Code原始 Markdown 源编辑

文件管理

项目结构

元素描述
根目录主项目文件夹
子目录组织笔记的文件夹
文件独立 Markdown 文件
附件图片和其他文件

文件操作

操作快捷键描述
新建文件Ctrl+N创建新 Markdown 文件
打开文件Ctrl+O打开现有文件
保存Ctrl+S保存当前文件
快速打开Ctrl+P模糊文件搜索
新建目录-创建新文件夹

支持的文件格式

格式读取写入
Markdown (.md)
Text (.txt)
YAML (.yaml)
JSON (.json)
LaTeX (.tex)
HTML (.html)

写作功能

格式工具栏

按钮功能
Bold使文本加粗(Ctrl+B)
Italic使文本倾斜(Ctrl+I)
Code行内代码格式
Link插入超链接(Ctrl+K)
Image插入图片
List切换无序列表
Numbered切换有序列表
Quote切换引用块
Heading循环切换标题级别

键盘快捷键

快捷键操作
Ctrl+B加粗
Ctrl+I斜体
Ctrl+K插入链接
Ctrl+Shift+I插入图片
Ctrl+L插入列表
Ctrl+Shift+L插入有序列表
Ctrl+Q插入引用块
Ctrl+1-6标题级别 1-6
Ctrl+`切换代码块
Ctrl+H查找和替换

自动补全

触发补全
[[内部笔记链接
#标签
@引用
::表情符号
/斜杠命令

Zettelkasten 功能

创建链接

方式描述
内部链接[[笔记标题]]
带锚点[[笔记标题#标题]]
带别名[[笔记标题|显示文本]]
外部链接[text](url)

标签系统

标签类型语法示例
行内标签#tag#research
嵌套标签#parent/child#project/research
多词标签#[multi word tag]#[machine learning]

文件 ID 配置

设置描述示例
PatternID 生成模式%Y%m%d%H%M%S
PrefixID 前缀zettel-
SuffixID 后缀-note

生成的 ID 示例

20240115143025.md → 20240115143025
zettel-20240115-note.md → zettel-20240115-note

引用管理

Zotero 集成

步骤操作
1安装 Zotero 和 Better BibTeX 插件
2导出参考文献为 .bib 文件
3配置 Zettlr 使用 .bib 文件
4使用 @citation-key 插入引用

引用语法

语法结果
@smith2020Smith (2020)
[@smith2020](Smith, 2020)
[@smith2020, p. 42](Smith, 2020, p. 42)
[see @smith2020; @jones2021](see Smith, 2020; Jones, 2021)

参考文献生成

# 参考文献

::: {#refs}
:::

导出选项

导出格式

格式描述要求
PDF便携式文档格式Pandoc + LaTeX
DOCXMicrosoft WordPandoc
HTML网页Pandoc
LaTeXLaTeX 源码Pandoc
ODTOpenDocument TextPandoc
RTF富文本格式Pandoc
Plain Text纯文本内置

Pandoc 配置

设置描述
Pandoc 路径Pandoc 可执行文件路径
LaTeX 发行版用于 PDF 导出的 TeX Live 或 MiKTeX
参考文档用于 DOCX 导出的自定义模板
CSL 文件用于引用的 Citation Style Language

导出设置

设置描述
Title文档标题
Author作者姓名
Date出版日期
Template导出模板文件
Bibliography引用数据库文件
CSL引用样式文件

外观

主题

主题描述
Berlin简洁现代界面
Frankfurt经典编辑器外观
Bielefeld极简设计
Karl Marx Stadt暗色主题
Custom用户自定义 CSS 主题

字体设置

设置描述
编辑器字体编辑器中使用的字体
字体大小编辑器文本大小
行高行间距
代码字体代码块字体

编辑器设置

设置描述
行号在编辑器中显示行号
自动换行长行换行
拼写检查启用拼写检查器
打字机模式保持光标垂直居中
聚焦模式使非活跃段落变暗

搜索和过滤

搜索选项

选项描述
在文件中查找在当前文档内搜索
在目录中查找跨多个文件搜索
正则表达式使用正则模式
区分大小写精确匹配大小写
全词匹配仅匹配完整单词

过滤器

过滤器描述
标签过滤显示带有特定标签的文件
文件过滤按文件名过滤
日期过滤按修改日期过滤
ID 过滤按 Zettel ID 过滤

键盘导航

导航快捷键

快捷键操作
Ctrl+G跳转到行
Ctrl+P快速打开文件
Ctrl+Tab在打开的文件间切换
Ctrl+Shift+F全局搜索
Alt+Left后退
Alt+Right前进

总结

主题核心要点
用途面向学术的 Markdown 编辑器,带知识管理
Zettelkasten基于链接的笔记,带唯一 ID 和标签
引用Zotero 集成,使用 @citation-key 语法
导出通过 Pandoc 导出 PDF、DOCX、HTML
界面分屏视图,带文件管理器、编辑器和预览
自定义主题、字体和键盘快捷键