Markdown 常用写法速查总结# Markdown 常用写法速查总结
一、核心排版语法（基础必掌握）
| 功能 | 语法示例 | 关键说明 |
|---|---|---|
| 标题（1-6级） | # 一级标题 ## 二级标题 ... ###### 六级标题 | 级别数字越多，字体越小；一级/二级最常用 |
| 加粗 | **加粗文本** | 包裹文本的**需紧贴内容（无多余空格） |
| 斜体 | *斜体文本* | 单星号包裹，可与加粗组合：***加粗斜体*** |
| 删除线 | ~~删除线文本~~ | 标注废弃/作废内容 |
| 下划线 | <u>下划线文本</u> | Markdown 原生不支持，用 HTML 标签实现 |
| 有序列表 | 1. 第一项 2. 第二项 | 数字+小数点，自动排序（数字乱序也不影响） |
| 无序列表 | - 第一项 * 第一项 + 第一项 | 三种符号均可，推荐用-，嵌套加 2 个空格 |
| 任务列表 | - [x] 已完成 - [ ] 未完成 | 括号内x代表勾选，空格代表未勾选 |
| 引用 | > 一级引用 >> 二级嵌套引用 | 可换行续写，空行结束引用 |
| 分割线 | --- *** ___ | 单独一行，前后留空行，三种写法效果一致 |
二、进阶功能语法（高频实用）
| 功能 | 语法示例 | 关键说明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 普通链接 | [链接名称](https://xxx.com) | 括号内填 URL，支持相对路径（本地文件） | |||||||||
| 带备注链接 | [GitHub](https://github.com/ "代码托管平台") | 引号内为鼠标悬浮提示文本 | |||||||||
| 图片 |  | 描述为无障碍阅读用，可省略；支持尺寸（部分编辑器） | |||||||||
| 图片+链接 | [](链接URL) | 点击图片跳转至指定链接 | |||||||||
| 行内代码 | print("hello") | 单个反引号包裹，标注变量/函数/命令 | |||||||||
| 块级代码 | python<br>print("hello")<br> | 三个反引号开头/结尾，指定语言（如python）实现语法高亮 | |||||||||
| 表格 | ` | 列1 | 列2 | ----- | ----- | 内容 | 内容 | ` | 第二行控制对齐：:---左对齐/:---: 居中/---:右对齐 | ||
| 行内公式 | $E=mc^2$ | 需编辑器支持 LaTeX，嵌入文本中 | |||||||||
| 块级公式 | $$\sum_{i=1}^n i = \frac{n(n+1)}{2}$$ | 单独成块居中显示，支持复杂公式/方程组 | |||||||||
| 注释 | <!-- 隐藏的备注内容 --> | 渲染后完全隐藏，仅编辑模式可见 | |||||||||
| 脚注 | 正文内容[^1]<br>[^1]: 脚注说明 | 脚注会自动显示在文档末尾 |
三、避坑提示（关键规则）
- 块级元素（标题、代码块、表格、引用）需单独成行，前后留空行，避免渲染异常；
- 代码块结束符（```）必须单独一行，且无多余空格/字符；
- 表格竖线（|）前后可加空格，不影响渲染，优先保证可读性；
- 特殊符号转义：用
\转义 Markdown 语法符（如\#显示#，\*显示*）； - 跨平台兼容：优先用标准语法（如
---分割线），避免编辑器专属扩展语法。
四、快速使用技巧
- 编辑器推荐：VS Code（插件全）、Typora（实时预览）、Obsidian（笔记专用）；
- 批量转换：用 Pandoc 命令行（
pandoc 文件名.md -o 文件名.pdf）导出 PDF/Word； - 语法校验：粘贴到 GitHub 编辑框，实时预览是否渲染正常。
