Markdown 语法
Markdown 是一种轻量级标记语言，让你用纯文本格式就能写出带标题、列表、链接等格式的文档，最终可以转换为 HTML、PDF 等。下面把常用用法整理成一份快速参考。
一、基础语法（最常用）
1. 标题
markdown
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
注：# 后需跟一个空格。
2. 段落与换行
段落之间用空行分隔。
换行：在一行末尾加两个空格再回车；或者直接写一个新段落（空行）。
3. 强调
markdown
斜体 或 斜体
粗体 或 粗体
粗斜体
删除线
4. 列表
无序列表（可用 - * +）
markdown
- 苹果
- 香蕉
- 子项（缩进2或4空格）
- 橙子
有序列表
markdown
- 第一项
- 第二项 3. 子项1 4. 子项2
- 第三项
5. 链接
markdown
6. 图片
markdown
7. 引用
markdown
这是一段引用。 可以跨行。
嵌套引用
8. 代码
行内代码：code
代码块：用三个反引号 ``` 包裹，并可以指定语言（实现语法高亮）
markdown
def hello():
print("Hello")
9. 水平分割线
单独一行使用三个或更多 - * _
markdown
10. 表格
markdown
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |
11. 任务列表（GitHub 风格）
markdown
- 已完成任务
- 未完成任务
12. 转义字符
用反斜线 \ 转义 Markdown 格式符号，例如 \* 显示星号。
二、常见用法场景
| 用途 | 说明 |
|---|---|
| GitHub / GitLab 仓库 | README.md 展示项目说明、文档、issue 模板 |
| 个人笔记 | Obsidian, Typora, Joplin, Logseq, VS Code + 插件 |
| 技术博客 | 静态网站生成器（Hugo, VuePress, MkDocs） |
| 论坛/评论区 | Reddit, Stack Overflow, 飞书/钉钉（部分支持） |
| 写书/报告 | 搭配 Pandoc 导出 PDF, ePub, Word |
三、使用环境与工具
编辑器推荐
Typora – 所见即所得，极简
VS Code – 安装
Markdown All in One或Markdown Preview EnhancedObsidian – 双向链接，适合知识库
Jupyter Notebook – Markdown 单元格写解释
在线编辑器 – Dillinger, StackEdit
查看预览
GitHub / GitLab 自动渲染
README.md多数编辑器有"预览"按钮（Ctrl+Shift+V 在 VS Code 中）
转换成其他格式
Pandoc（命令行）：
bash
pandoc input.md -o output.pdf pandoc input.md -o output.docx
或用 Typora / VS Code 插件导出。
四、注意事项
不同平台对 Markdown 的扩展支持不同（如表格、任务列表）。GitHub 风格（GFM）是事实标准。
若需要复杂排版（图表、公式），可使用嵌入 HTML 或 LaTeX（许多引擎支持）。
行内 HTML 有效：例如
<span style="color:red">红色文字</span>。换行规则容易踩坑：建议用空行分段，不要依赖"两个空格+回车"。
五、快速上手示例
markdown
我的笔记标题
今天任务
- 学习 Markdown
- 写一篇教程
print("Hello")是代码片段。
ls -la
这是一句名言
—— 佚名
姓名 年龄 张三 20
你可以把上面的内容复制到记事本，保存为 test.md，然后用浏览器打开（如果有渲染插件）或拖到 Typora 里看看效果。
总结：Markdown 的核心就是记住标题、列表、链接、代码块这几种语法，其他随时查阅就能搞定。一旦用熟，你会发现写结构化的文本比 Word 快得多。