核心答案：Markdown 是用纯文本符号标记排版的轻量语法——# 是标题、** 是粗体、- 是列表、``` 是代码块。2004 年由 John Gruber 发明，如今是 GitHub、知乎、公众号编辑器的事实标准，10 分钟即可掌握。
基础语法速查
| 效果 | 语法 | 示例 |
|---|---|---|
| 一级标题 | # 文字 | # 报告 |
| 二级标题 | ## 文字 | ## 第一章 |
| 粗体 | 文字 | 重点 |
| 斜体 | *文字* | *强调* |
| 删除线 | ~~文字~~ | ~~作废~~ |
| 无序列表 | - 项目 | - 苹果 |
| 有序列表 | 1. 项目 | 1. 第一步 |
| 引用 | > 文字 | > 名言 |
| 链接 | [文字](URL) | [官网](https://example.com) |
| 图片 |  |  |
| 分割线 | --- 或 *** | --- |
表格与代码块
表格：竖线分隔列，第二行 :--- 控制对齐——
| 左对齐 :--- | 居中 :---: | 右对齐 ---: |
三个竖线单元格一行，行数不限。冒号在左=左对齐、两边=居中、在右=右对齐。
代码块：三个反引号包裹，首行标注语言可获得语法高亮（``python、`js）。行内代码用单个反引号：const a = 1`。
实例：写接口文档时，用表格列「参数/类型/说明」，用 ```json 代码块展示返回示例，比 Word 排版快 5 倍且可直接贴进 GitLab。
扩展语法
- 任务列表：- [ ] 待办 / - [x] 已完成（GitHub 支持勾选交互）
- 脚注：正文[^1] + 文末 [^1]: 说明
- 目录：Typora 等编辑器输入 [TOC] 自动生成
- 数学公式：$E=mc^2$（LaTeX 语法，需渲染器支持）
- HTML 混排：Markdown 里可直接写
、等标签兜底
写作技巧
- 标题层级不跳级：# 之后用 ## 而不是 ###，目录生成器依赖层级
- 列表与正文空行：列表前后留空行，避免渲染粘连
- 长文先写骨架：先列 ## 小节标题再填内容，结构清晰
- 代码必标语言：``
python 比`` 的高亮体验好得多
常见误区
- 「#」后忘空格：#标题 在很多渲染器里不生效，必须 # 标题
- 表格竖线不对齐：源码里竖线没对齐没关系（渲染只看分隔），但表头分隔行（|---|）不能省略
- 复制 Word 内容直接贴：Word 富文本会带隐形格式，先过纯文本编辑器再转 Markdown
- 在 Markdown 里调字号颜色：Markdown 只管结构不管样式，需要样式时用 HTML 标签或交给发布平台主题