第 2 章 · Markdown 与编辑器
适用版本：Joplin 3.x
本章介绍编辑器模式、Markdown 语法、KaTeX 公式、Mermaid 图表与常用快捷键。
1. 编辑器模式
Markdown 编辑器直接写源码；所见即所得编辑器输入时直接渲染。两种模式编辑同一份源码，可随时切换、不丢格式，并且都支持大纲面板快速定位章节。对新手来说，从所见即所得模式开始更友好；熟悉语法后可以切换到源码模式提高输入效率。大纲面板位于左侧栏，可以按标题层级快速跳转；编辑器还支持字数统计、拼写检查与自动补全，写作体验接近专业编辑器。
2. Markdown 语法速览
| 语法 | 效果 |
|---|---|
# ~ ###### | 六级标题，自动进入大纲 |
- / 1. | 无序 / 有序列表 |
**加粗**、*斜体* | 文字强调 |
[文字](https://地址) | 超链接 |
- [ ] | 可勾选待办事项 |
以上语法足够覆盖 90% 的日常笔记场景。进阶用户可以进一步学习表格、脚注、任务列表与嵌套引用，这些语法在 Joplin 中都有完整支持。写笔记时建议养成分段与层级标题的习惯，后续整理和检索都会更方便；快捷键在不同平台略有差异，macOS 用户注意 Cmd 与 Ctrl 的对应关系。
3. KaTeX 数学公式
Joplin 用 KaTeX 本地渲染公式，无需联网。行内公式用 $...$，块级公式用 $$...$$，如 $E=mc^2$。KaTeX 渲染速度快，公式与文字混排自然，适合理工科笔记；行内公式与中文之间建议留空格，避免排版过密。如果公式显示为原始代码，通常是代码块语言被设置成了 text，改为 markdown 即可。完整语法见官方文档 Markdown 帮助页 与 GitHub 仓库。
4. Mermaid 图表
在代码块中指定 mermaid 语言即可绘制流程图、时序图、甘特图，渲染在本地完成。Mermaid 还支持类图、状态图等类型，足以覆盖日常文档需求；更复杂的图表可以用 Draw.io 插件嵌入。配合 笔记组织 与 功能特性 可以发挥编辑器的最大价值。
5. 常用快捷键
Ctrl+N/Cmd+N：新建笔记Ctrl+P/Cmd+P：快速查找笔记Ctrl+F：当前笔记内查找Ctrl+,/Cmd+,：打开设置
完整快捷键列表可在官方文档查询，也可以在「设置 → 键盘快捷键」中按自己的习惯自定义。除了默认快捷键，你还可以为常用命令绑定组合键。配合 安装初始化 与 新手教程，可以更快上手。
常见问题
数学公式没有渲染成图形怎么办？
确认公式用 $...$ 或 $$...$$ 正确包裹，且代码块语言为 markdown 而非 text。
两种编辑器切换会丢格式吗？
不会。两种模式编辑的是同一份 Markdown 源码，切换只是渲染方式变化。
Markdown 语法不难，建议边写边看预览效果，常用的加粗、列表与链接符号很快就能记住，写作效率会明显提升。