标准 Markdown 速览
从标题到表格，一份能在 Obsidian 里直接跑通的基础语法清单
标准 Markdown 速览
打开 Obsidian，新建一篇笔记，你会看到一片纯白的编辑区。没有工具栏，没有格式按钮——这不是简陋，而是一种克制的承诺：你只需要键盘，就能写出结构清晰、可被任何文本编辑器打开的笔记。这份承诺的载体，就是 Markdown。
Markdown 是一种用纯文本表达排版的语法。Obsidian 在 CommonMark 与 GitHub Flavored Markdown 的基础上做了扩展，但万丈高楼平地起，这一篇我们先盘清最基础、也最常用的那一层。
标题与段落
标题用 # 开头，几个 # 就是几级，最多六级：
# 一级标题
## 二级标题
### 三级标题
段落之间要空一行。只按一次回车的两行，在阅读视图里会被合并成同一段——这是新手最常踩的坑。若想在同一段内换行，可以在行末留两个空格，或直接按 Shift+Enter。
强调：加粗、斜体、删除线
| 效果 | 语法 | 示例 |
|---|---|---|
| 加粗 | **文字** | 重点 |
| 斜体 | *文字* | 略作强调 |
| 删除线 | ~~文字~~ | |
| 加粗+斜体 | ***文字*** | 又黑又斜 |
记忆窍门：* 是斜体，** 是加粗，“多一颗星，多一分重”。需要嵌套时，外层用双符号、内层用单符号，比如 **外层加粗，_内层斜体_**，避免符号打架。
列表：有序、无序、任务
无序列表用 -、*、+ 任一皆可，团队里建议统一用 -：
- 苹果
- 香蕉
- 牛奶香蕉
有序列表用数字加点：
1. 第一步
2. 第二步
任务列表是 Obsidian 的高频用法，方括号里一个空格是待办，一个 x 是完成：
- [ ] 写完这一章
- [x] 喝杯咖啡
小技巧：方括号里填任意字符都会被识别为”已完成”，比如 - [?]、- [-]，适合做半完成、阻塞等中间态标记。
代码：行内与代码块
行内代码用一对反引号包裹：`print("hi")`。
代码块用三个反引号围起，并在第一行写明语言即可获得语法高亮：
```python
def greet(name):
return f"Hello, {name}"
```
要在代码块里再嵌套代码块？把外层的反引号多加一个即可，例如四个反引号包三个反引号。这是写教程时绕不开的小窍门。
链接与图片
外部链接沿用标准 Markdown：
[Obsidian 官网](https://obsidian.md)
外部图片只需在前面加一个 !，还可在链接后用 |宽度 控制尺寸：
至于 Vault 内部的笔记和图片，Obsidian 有更强的玩法——双向链接与嵌入，那是下一篇的主角。
表格、引用、分隔线
表格用竖线分列、连线分头：
| 姓名 | 城市 |
| --- | --- |
| 张三 | 北京 |
| 李四 | 上海 |
引用用 >，分隔线用三个及以上的 *、- 或 _：
> 这是一句引文。
---
表格里的竖线如果和别处冲突（比如内嵌链接别名），要在 | 前加反斜杠转义：[[笔记\|显示名]]。
转义：让符号回归本意
当你要写 1. 不是列表 却被自动转成有序列表时，在符号前加反斜杠即可：1\. 不是列表。常见的需要转义的字符有 \*、\_、\#、\`、\|、\~。
掌握以上这些，你已经能在 Obsidian 里写出一篇结构工整的笔记。但 Markdown 只是地基——真正让知识”活”起来的，是 Obsidian 在它之上铺的那层双向链接。下一章，我们就来揭开 [[ ]] 的秘密。