Markdown 基础语法速查与笔记应用特有写法
Joplin 的笔记基于 Markdown,遵循 CommonMark 规范,插件可再加扩展语法。下面这张速查表覆盖日常写作 95% 的场景。
核心语法速查
| 想要的效果 | 这样写 |
|---|---|
| 一级/二级/三级标题 | # 标题 / ## 标题 / ### 标题 |
| 加粗 | **加粗文字** |
| 斜体 | *斜体文字* |
| 无序列表 | - 项目(子项缩进两格) |
| 有序列表 | 1. 项目 |
| 引用 | > 引用内容 |
| 行内代码 | ` 代码 ` |
| 代码块 | 三个反引号包裹整段 |
| 分隔线 | 独立一行 --- |
| 链接 | [文字](地址) |
| 待办复选框 | - [ ] 未完成 / - [x] 已完成 |
代码块可标注语言获得高亮:
print("hello")
表格与公式
表格用竖线加连字符的写法搭建,完整说明单开了一页:Markdown 表格的写法与对齐。
数学公式与 Mermaid 图表也内置支持,见数学公式与图表的直接书写。
Joplin 特有的几个点
- 所见即所得切换:桌面端可分屏同时看源文本与渲染效果,语法边写边校;
- 外部编辑器友好:笔记是纯文本,能交给 VS Code、Vim 等编辑,见用外部编辑器写笔记;
- 链接笔记:Markdown 链接的地址可以写另一条笔记的 ID,实现笔记间互链(桌面端可用"复制笔记链接"拿到)。
为什么坚持纯文本
Markdown 文件十年后依然能打开——没有私有格式、没有软件依赖,用记事本都能读。这正是 Joplin 选择它当存储格式的原因,也见开源与开放格式意味着什么。
部分扩展语法(如公式、图表)依赖特定插件或版本,以官方最新版为准。