Tips
Markdown 是纯文本写作格式，用 # ** - [链接] 等几个符号替代鼠标点击。Obsidian、GitHub、飞书、AI 对话输出全基于它。五分钟学会，四年受益。
- 不要试图一天背下所有语法。今天学会
#**-[链接]——这四个就够日常 80% 的需求 - 单个回车不换行——要两个空格再回车，或者空一整行
- 不同平台各有"方言"：GitHub 支持任务列表
- [ ]，Obsidian 支持[[双向链接]]，飞书不支持双向链接但支持基础语法 - 图片路径用相对路径（
./images/xxx.png），换电脑或部署后不会挂
为什么学 Markdown
你在电脑上写东西，大概率是打开 Word、调字体、调字号、鼠标点"加粗"——手离开键盘几十次。用 Markdown，打字过程中顺手用符号标记格式：想加粗就在文字两边加 **，想列清单就在每行前加 -。写完是纯文本，在任何支持 Markdown 的工具里渲染出来都是排版好的样子。
更重要的是，你接触到的几乎所有写作和笔记工具都基于 Markdown：Obsidian 笔记、GitHub README、飞书文档、Notion 页面。AI（ChatGPT、Claude 等）的输出也默认是 Markdown 格式。学一次，所有平台都能用。
核心语法
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题（一般用到这就够了）
# 后面有空格。一级别和二级是页面最重要的层级。
文字格式
**粗体**
*斜体*
~~删除线~~
`行内代码`
列表
- 无序列表项 1
- 无序列表项 2
- 子项（前面空两格）
1. 有序列表项 1
2. 有序列表项 2
链接和图片
[链接文字](https://example.com)
代码块
```python
def hello():
print("Hello World")
```
三个反引号开始，三个反引号结束。开头的 python 表示语法高亮的语言。
表格
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A | B | C |
引用
> 这是一段引用文字。
> 可以多行。
去哪练习
不需要安装任何软件。打开 Obsidian 或 Typora 就能边写边看渲染效果。更简单：新建一个 .md 文件用记事本写，VS Code 打开预览（Ctrl+Shift+V）。
编辑器推荐
| 编辑器 | 适合谁 |
|---|---|
| VS Code + Markdown All in One 扩展 | 写代码 + 写文档一个工具搞定 |
| Typora | 所见即所得，纯写作体验最好 |
| Obsidian | 笔记 + 知识库，双向链接 |
| Notion / 飞书 | 协作场景 |
新手推荐 Typora 上手——打开直接写，左边源码右边预览，没有学习成本。熟练后切到 VS Code 统一工作流。
适用场景
- ✅ 课堂笔记、会议记录
- ✅ 技术文档、README
- ✅ 博客文章
- ✅ 实验记录
- ❌ 正式学术论文（→ LaTeX）
- ❌ 复杂排版（多栏、精确位置控制 → Word/LaTeX）
AI 协作
AI 输出的默认格式就是 Markdown。你让 AI 写一段内容 → 它返回带 # ** - 的格式文本 → 你直接粘贴到 Obsidian/GitHub/飞书 → 自动渲染为排版好的样子。
反过来，你描述需求（"给我画一个表格，列出三种排序算法的时间复杂度，用 Markdown"），AI 写给你。你学会 Markdown 语法后就能一眼看懂 AI 给的是什么、怎么能直接用了修。
进阶：GitHub Copilot 和 Claude Code 能直接在你写 Markdown 时补全表格、补全链接、补全代码块。