Markdown 是一种用纯文本写格式的语言。五分钟能学会,学会之后你写笔记、写文档、写公众号草稿都会换用它。
核心就一句:用几个符号表示格式,内容还是纯文本。 所以它能在任何地方打开,二十年后还能读。
一、最常用的八个语法
# 一级标题
## 二级标题
### 三级标题
**加粗** *斜体* ~~删除线~~
- 无序列表
- 第二项
- 缩进两个空格变成子项
1. 有序列表
2. 第二项
> 引用,用来放重点或别人的话
`行内代码`
```python
# 代码块,三个反引号包起来
print("hello")
```
[链接文字](https://example.com)

就这些。剩下的都是扩展语法,用到再查。
二、表格
| 姓名 | 部门 | 工号 |
|------|------|------|
| 张三 | 设计 | 001 |
| 李四 | 开发 | 002 |
第二行的 --- 是分隔线,必须有。想要对齐就在两边加冒号::--- 左对齐、---: 右对齐、:---: 居中。
三、写文档的四个实用技巧
1. 标题层级别跳
从 # 到 ### 逐级往下,别从一级直接跳到三级。跳级会让目录结构乱,导出 PDF 或网页时排版会出问题。
2. 一行只做一件事
Markdown 里换行不生效,要空一行才分段。所以别在一行里塞三句话,读起来累。
3. 用列表代替长段落
超过四行的段落,考虑拆成列表。纯文本没有加粗和颜色,靠结构传递信息。
4. 图片用相对路径
写  而不是绝对路径。这样整个文件夹搬到哪都能用。
四、用什么工具写
| 工具 | 适合 | 说明 |
|---|---|---|
| Typora | 写作 | 所见即所得,付费但值得 |
| Obsidian | 知识库 | 本地文件、双链、插件多 |
| VS Code | 技术文档 | 免费,预览方便,适合写代码相关 |
| Notion | 协作 | 本质是块编辑器,但支持 Markdown 语法 |
| 语雀 / 飞书文档 | 团队 | 中文友好,支持导入导出 |
五、导出时注意什么
Markdown 只是中间格式,最终要导出成 PDF、Word 或网页:
- 导出 PDF:先在编辑器里预览,表格太宽会溢出。长表格改用列表或拆表。
- 导出 Word:用 Pandoc,配合模板文件可以保留样式。
- 发布网页:大多数静态站生成器(Hugo、Hexo、Astro)原生支持 Markdown。
常见问题
Q:换行为什么不生效?
A:Markdown 把单个换行当空格。要分段就空一行,要强制换行就在行尾加两个空格。
Q:星号会被当成格式怎么办?
A:前面加反斜杠转义,\* 就显示成星号。
Q:不同工具渲染结果不一样?
A:正常。Markdown 有多个方言(CommonMark、GFM 等)。写通用文档时只用基础语法,别用太偏的扩展。
Q:值得专门学吗?
A:值得。投入五分钟,之后所有写作场景都能用,而且永远不怕软件倒闭导致文档打不开。