基础篇：Markdown

分类维度	类别名称	核心特点	典型代表/规范	常见用途
语法标准	原始 Markdown	基础语法，功能有限，无表格/围栏代码块	John Gruber 的 `Markdown.pl`	简单文档
	CommonMark	严格规范，消除歧义	`cmark`, `league/commonmark`	通用解析基础
	GitHub Flavored Markdown (GFM)	扩展表格、任务列表、删除线、自动链接	GitHub, GitLab	代码托管、技术文档
	MultiMarkdown	增加元数据、脚注、目录、数学公式	MultiMarkdown	学术写作、复杂文档
	Pandoc’s Markdown	极丰富的扩展，支持文献引用、LaTeX	Pandoc	文档转换、出版
功能扩展	基础排版	标题、段落、列表、链接、图片、引用	所有 Markdown	通用写作
	表格与列表增强	表格、任务列表、定义列表	GFM, MultiMarkdown	数据展示、待办清单
	代码相关	围栏代码块、语法高亮	GFM, CommonMark	技术文档、代码分享
	数学与学术	LaTeX 公式、文献引用	Pandoc, MultiMarkdown	学术论文、科学笔记
	图表支持	Mermaid、PlantUML 等	GFM (部分), Obsidian	流程图、时序图
	元数据与结构化	YAML Front Matter、脚注、TOC	MultiMarkdown, Pandoc	静态站点生成、书籍
应用场景	技术文档	README、Wiki、API 文档	GitHub, GitLab	开源项目、开发者文档
	笔记与知识管理	个人知识库、双向链接	Obsidian, Logseq, Notion	学习笔记、知识网络
	静态网站生成	博客、文档站内容源	Jekyll, Hugo, VuePress	个人博客、产品文档
	论坛与聊天	帖子、评论、消息格式化	Reddit, Stack Overflow	在线讨论
	电子邮件	纯文本邮件转 HTML	HEY, Mailbrew	营销邮件、简报
	数据科学	Jupyter Notebook 文本单元格	Jupyter, R Markdown	数据分析报告
实现引擎	JavaScript	快速、可扩展、AST 操作	`marked`, `remark`	Node.js、浏览器
	C	高性能、标准规范	`cmark-gfm`	GitHub 后台、命令行工具
	Python	支持扩展插件	`Python-Markdown`	Pelican, MkDocs
	Ruby	Jekyll 默认解析器	`kramdown`	静态站点
	万能转换器	支持大量输入/输出格式	`pandoc`	文档格式转换、出版
	集成环境	所见即所得、实时预览	Typora, Obsidian	日常笔记、写作

三、相关概念：

```mermaid

flowchart TD
C1["📌 标题"] --> C1_syn["语法：# 到 ######"]
C1 --> C1_imp["重要性：最高"]
C1 --> C1_ex["举例： # 一级标题"]

C2["📌 段落与换行"] --> C2_syn["语法：空行分隔段落，行末两空格+换行"]
C2 --> C2_imp["重要性：极高"]
C2 --> C2_ex["举例：第一段末尾两个空格 \n第二段"]

C3["📌 加粗和斜体"] --> C3_syn["语法：**粗体** *斜体*"]
C3 --> C3_imp["重要性：极高"]
C3 --> C3_ex["举例：**粗体文字** 和 *斜体文字*"]

C4["📌 列表"] --> C4_syn["语法：- 无序 / 1. 有序"]
C4 --> C4_imp["重要性：极高"]
C4 --> C4_ex["举例：- 苹果\n- 香蕉\n1. 第一\n2. 第二"]

C5["📌 链接"] --> C5_syn["语法：[文字](url)"]
C5 --> C5_imp["重要性：高"]
C5 --> C5_ex["举例：[百度](https://baidu.com)"]

C6["📌 图片"] --> C6_syn["语法：![alt](url)"]
C6 --> C6_imp["重要性：高"]
C6 --> C6_ex["举例：![logo](logo.png)"]

C7["📌 代码"] --> C7_syn["语法：`code` 或 ```代码块```"]
C7 --> C7_imp["重要性：高"]
C7 --> C7_ex["举例：`print('hello')` 或 ```python ... ```"]

C8["📌 引用块"] --> C8_syn["语法：> 引用内容"]
C8 --> C8_imp["重要性：中等偏高"]
C8 --> C8_ex["举例：> 这是一段引用"]

C9["📌 转义字符"] --> C9_syn["语法：\\ 后跟特殊字符"]
C9 --> C9_imp["重要性：中等"]
C9 --> C9_ex["举例：\\# 不是标题"]

C10["📌 水平分割线"] --> C10_syn["语法：--- 或 ***"]
C10 --> C10_imp["重要性：中等"]
C10 --> C10_ex["举例：--- 单独一行"]

C11["📌 表格"] --> C11_syn["语法：|列1|列2|"]
C11 --> C11_imp["重要性：中等"]
C11 --> C11_ex["举例：| 姓名 | 年龄 |\n| 张三 | 20 |"]

C12["📌 内嵌 HTML"] --> C12_syn["语法：直接写HTML标签"]
C12 --> C12_imp["重要性：中等"]
C12 --> C12_ex["举例：下划线"]

C13["📌 任务列表"] --> C13_syn["语法：- [ ] 或 - [x]"]
C13 --> C13_imp["重要性：中等偏低"]
C13 --> C13_ex["举例：- [x] 已完成\n- [ ] 未完成"]

C14["📌 删除线"] --> C14_syn["语法：~~文字~~"]
C14 --> C14_imp["重要性：中等偏低"]
C14 --> C14_ex["举例：~~删除的内容~~"]

C15["📌 自动链接"] --> C15_syn["语法：<url> 或直接写URL"]
C15 --> C15_imp["重要性：中等偏低"]
C15 --> C15_ex["举例：<https://example.com>"]

C16["📌 脚注"] --> C16_syn["语法：[^1] 及 [^1]: 说明"]
C16 --> C16_imp["重要性：较低"]
C16 --> C16_ex["举例：这是脚注[^1]\n[^1]: 脚注内容"]

C17["📌 YAML Front Matter"] --> C17_syn["语法：文档开头的 --- 块"]
C17 --> C17_imp["重要性：较低"]
C17 --> C17_ex["举例：---\ntitle: 标题\n---"]

C18["📌 数学公式"] --> C18_syn["语法：$E=mc^2$ 或 $$ $$"]
C18 --> C18_imp["重要性：低"]
C18 --> C18_ex["举例：$a^2 + b^2 = c^2$"]

C19["📌 图表"] --> C19_syn["语法：```mermaid```"]
C19 --> C19_imp["重要性：低"]
C19 --> C19_ex["举例：```mermaid\ngraph TD\nA-->B\n```"]

C20["📌 定义列表"] --> C20_syn["语法：术语\n: 定义"]
C20 --> C20_imp["重要性：极低"]
C20 --> C20_ex["举例：Markdown\n: 一种标记语言"]

C21["📌 目录"] --> C21_syn["语法：[TOC] 或自动生成"]
C21 --> C21_imp["重要性：极低"]
C21 --> C21_ex["举例：[TOC] 自动生成"]

C1 --> C2
C2 --> C3
C3 --> C4
C4 --> C5
C5 --> C6
C6 --> C7
C7 --> C8
C8 --> C9
C9 --> C10
C10 --> C11
C11 --> C12
C12 --> C13
C13 --> C14
C14 --> C15
C15 --> C16
C16 --> C17
C17 --> C18
C18 --> C19
C19 --> C20
C20 --> C21

```

四、范围：

```mermaid
flowchart LR
subgraph Core[✅ 核心范围 - 直接支持]
direction TB
A1[标题 / 段落 / 换行]
A2[加粗 / 斜体 / 删除线]
A3[列表 / 引用 / 代码块]
A4[链接 / 图片 / 分割线]
A5[简单表格 / 行内HTML]
end

subgraph Extension[⚠️ 扩展范围 - 需GFM或第三方工具]
direction TB
B1[任务列表 - 未完成或已完成]
B2[脚注 / 定义列表]
B3[数学公式 - 需LaTeX渲染]
B4[图表 - Mermaid或PlantUML]
B5[YAML前置元数据 / 自动目录]
end

subgraph Out[❌ 超出范围 - 不直接适合]
direction TB
C1[复杂排版 - 多栏或浮动布局]
C2[专业出版 - 交叉引用或文献管理]
C3[动态交互 - 表单或脚本]
C4[精准定位 - 绝对坐标]
C5[富媒体嵌入 - 视频或音频]
end

Start((Markdown)) --> Core
Start --> Extension
Start --> Out

Core -.->|基本能力| Extension
Extension -.->|不能替代| Out

style Core fill:#e1f5e1,stroke:#2e7d32,stroke-width:2px
style Extension fill:#fff3e0,stroke:#ed6c02,stroke-width:2px
style Out fill:#ffebee,stroke:#c62828,stroke-width:2px
style Start fill:#bbdefb,stroke:#1565c0,stroke-width:2px
```

五、用途：

```mermaid
flowchart LR
subgraph Tech[📄 技术文档]
A1[README / 项目说明]
A2[API 文档 / Wiki]
A3[代码仓库 / GitHub]
end

subgraph Blog[✍️ 博客与写作]
B1[静态站点生成器]
B2[Hugo / Hexo / Jekyll]
B3[技术文章 / 教程]
end

subgraph Note[📒 笔记与知识管理]
C1[个人笔记 / Obsidian]
C2[知识库 / Notion]
C3[大纲 / Logseq]
end

subgraph Forum[💬 论坛与社区]
D1[Reddit / Stack Overflow]
D2[Discourse / 评论系统]
D3[帖子格式化]
end

subgraph Code[💻 代码分享]
E1[聊天中展示代码]
E2[代码审查 / PR描述]
E3[带高亮的代码块]
end

subgraph Light[📋 轻量级排版]
F1[会议纪要 / 待办清单]
F2[简单报告 / 邮件]
F3[备忘录]
end

subgraph Data[📊 数据科学]
G1[Jupyter Notebook 文本单元格]
G2[数据分析说明]
end

subgraph Site[🌐 静态站点]
H1[文档站点 / VuePress]
H2[Docusaurus / MkDocs]
end

Start((Markdown)) --> Tech
Start --> Blog
Start --> Note
Start --> Forum
Start --> Code
Start --> Light
Start --> Data
Start --> Site

style Start fill:#2d6a4f,stroke:#1b4332,stroke-width:2px,color:#fff
style Tech fill:#e9f5f0,stroke:#2d6a4f
style Blog fill:#fff3e0,stroke:#ed6c02
style Note fill:#e3f2fd,stroke:#1565c0
style Forum fill:#fce4ec,stroke:#c62828
style Code fill:#f3e5f5,stroke:#6a1b9a
style Light fill:#fff9c4,stroke:#f9a825
style Data fill:#e0f7fa,stroke:#00838f
style Site fill:#efebe9,stroke:#5d4037
```

六、作用：

用纯文本格式快速编写结构化文档，并方便地转换为 HTML 或其他富文本格式。

七、方式：

“Markdown方式” = 用简单的标记符号在纯文本中表达格式 + 依赖渲染器呈现为富文本 + 必要时嵌入 HTML 扩展能力。（Markdown 无法实现复杂表格、视频嵌入等高级功能时，可以直接在文档中写 HTML 标签，渲染时会正常解析）

```mermaid
flowchart LR
A[使用任意文本编辑器\n写 Markdown 源码] --> B[保存为 .md 文件]
B --> C{渲染方式}
C --> D1[在 GitHub / GitLab\n自动渲染为 HTML]
C --> D2[用 Typora / Obsidian\n实时预览]
C --> D3[通过 Pandoc 等工具\n导出 PDF / Word]
C --> D4[静态网站生成器\n生成博客页面]
```

八、途径：

8.1 使用途径

```mermaid
flowchart TD
subgraph 编写途径
W1[文本编辑器 记事本 / VS Code / Vim]
W2[专用 Markdown 编辑器 Typora / Marktext / Zettlr]
W3[笔记软件 Obsidian / Notion / Logseq]
W4[在线平台 GitHub / Stack Overflow / 知乎]
end

subgraph 渲染途径
R1[实时预览 Typora / Obsidian 所见即所得]
R2[静态站点生成器 Hugo / Hexo / Jekyll → HTML]
R3[转换工具 Pandoc → PDF / Word / LaTeX]
R4[平台自动渲染 GitHub / GitLab 自动显示]
end

Start[编写 Markdown 源码] --> 编写途径
编写途径 --> 渲染途径
渲染途径 --> Output[最终输出：网页 / PDF / 笔记 / 文档]

style Start fill:#2d6a4f,color:#fff
style Output fill:#1565c0,color:#fff
```

8.2 从源码到呈现的完整路径

步骤	途径	工具/平台示例
1. 编写	任意文本编辑器或专用编辑器	VS Code, Typora, Obsidian
2. 存储	本地 `.md` 文件或云端同步	硬盘, GitHub, 云盘
3. 版本管理	Git 跟踪纯文本变更	GitHub, GitLab, Bitbucket
4. 渲染/转换	根据目标选择渲染器	GitHub 自动渲染；Pandoc 转 PDF；静态生成器建站
5. 发布/分享	输出为网页、PDF 或直接分享源码	博客、文档站、邮件、打印

8.3 学习途径

途径	说明
官方教程	John Gruber 的原始语法说明，CommonMark 规范
在线互动教程	如 Markdown Tutorial、Learn Markdown 等，边学边练
编辑器内置指引	Typora、VS Code 等软件中的语法提示或帮助文档
速查表（Cheat Sheet）	一张表总结所有常用语法，快速查阅
实践出真知	直接在 GitHub Issue、README 或笔记软件中试写

8.4 不同角色的典型途径

程序员：VS Code + 预览插件 → 写 README → GitHub 自动渲染。
作家/博主：Typora 写稿 → 导出 HTML → 发布到静态博客。
学生/研究者：Obsidian 记笔记 → Pandoc 转为 PDF 提交作业。
普通用户：在论坛发帖时直接写 Markdown → 平台自动格式化。

九、原理：

基于规则的纯文本标记 + 上下文无关文法解析 + 目标格式（通常是 HTML）的生成。

9.1 核心工作流程

```mermaid

flowchart LR
A[Markdown 源码 纯文本 + 标记符号] --> B[解析器 Parser]
B --> C[抽象语法树 AST，一种结构化的内存表示，描述了标题、段落、列表等元素的层级关系。]
C --> D[渲染器 Renderer]
D --> E[输出格式 HTML / PDF / 其他]
```

9.2 渲染原理

AST 与输出格式无关，渲染器只需定义 每种节点类型对应的输出模板。例如：

AST 节点类型	渲染为 HTML	渲染为 LaTeX
`heading` 级别1	`<h1>...</h1>`	`\section{...}`
`paragraph`	`<p>...</p>`	空行 + 文本
`strong`	`<strong>...</strong>`	`\textbf{...}`

9.3 举例：一句话的解析与渲染过程

输入：

markdown

这是一个 **粗体** 示例。

分块：整行为一个 paragraph 块。
行内解析：扫描到 **，找到下一个 **，将中间内容标记为 strong 节点。

AST 结构：

text

paragraph
├── text("这是一个 ")
├── strong
│   └── text("粗体")
└── text(" 示例。")

渲染 HTML：

html

<p>这是一个 <strong>粗体</strong> 示例。</p>

9.4 常见误解澄清

Markdown 不是正则表达式驱动的：虽然早期简单实现用正则，但完整解析需要状态机或递归下降解析器（因为存在嵌套和上下文敏感，例如列表中的代码块）。
Markdown 不直接生成 PDF/Word：必须经过中间格式（HTML 或 AST）再转换，或使用支持多输出的渲染器（如 Pandoc）。
不同解析器输出可能不同：原始标准存在歧义，所以 CommonMark 和 GFM 尝试统一行为。

十、位置：

“Markdown 位置” = 它在文档编写流程中的中间层角色 + 在标记语言谱系中的轻量级定位 + 语法中对元素缩进/换行等有限的位置控制能力。

10.1 在文档处理流程中的位置

```mermaid
flowchart LR
A[大脑构思] --> B[纯文本 + 轻量标记 Markdown 源码]
B --> C[解析器 / 渲染器]
C --> D[HTML / PDF / Word]
D --> E[屏幕 / 纸张 / 网页]
```

10.2 在标记语言谱系中的位置

标记语言	复杂度	可读性（源码）	适用场景
纯文本	极低	⭐⭐⭐⭐⭐	笔记、日志
Markdown	低	⭐⭐⭐⭐	技术文档、博客、论坛
reStructuredText	中	⭐⭐⭐	Python 文档
HTML	中高	⭐⭐	网页结构
LaTeX	高	⭐⭐	学术论文、书籍
XML	高	⭐	数据交换

10.3 在语法层面：“位置”相关的概念

如果是指 Markdown 语法中控制元素位置的方式（尽管 Markdown 本身不强调精确位置），常见的有：

需求	Markdown 做法	说明
标题层级	`#` 个数表示位置（一级、二级）	通过井号数量表达结构深度
列表缩进	空格 / Tab 控制嵌套层级	`- 一级\n - 二级`（两个空格）
图片对齐	无法直接控制，需用 HTML	`<img align="left">`
文本居中	无，需 HTML/CSS	`<div align="center">`
换行	行末两个空格 + 回车	精确控制换行位置
分割线	`---` 单独一行	章节分隔位置
锚点跳转	`[链接](#标题)`	页面内定位到标题位置

10.4 在开发/生态中的位置

版本控制系统（Git）：Markdown 是首选格式，因为 diff 清晰，不会像二进制文件那样难以合并。
静态网站生成器：Markdown 作为内容源文件，位于 content/ 目录下，通过生成器输出到 public/。
编辑器：通常在左侧编辑区（源码），右侧预览区（渲染后）——位置布局。

十一、价值：

用最低的心智成本，实现结构清晰、跨平台通用的文档写作。

11.1与其他格式的对比价值

特性	Markdown	Word	LaTeX	HTML
编写难度	极低	低（但易被样式分心）	高	中
源码可读性	⭐⭐⭐⭐⭐	⭐（二进制/XML）	⭐⭐⭐	⭐⭐
版本控制友好	⭐⭐⭐⭐⭐	⭐	⭐⭐⭐⭐	⭐⭐⭐⭐
排版自由度	⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
学习成本	⭐（10分钟）	⭐⭐	⭐⭐⭐⭐	⭐⭐⭐

十二、联系：

12.1 与格式/语言的联系

12.2 与工具/平台的联系

工具/平台类型	代表	联系
代码托管平台	GitHub、GitLab、Gitee	README、Wiki、Issue 全面支持 Markdown 渲染，成为开发协作语言
静态站点生成器	Hugo、Hexo、Jekyll、VuePress	以 Markdown 作为内容源，生成完整 HTML 网站
笔记软件	Obsidian、Notion、Typora、Logseq	以 Markdown 为基础格式，扩展双向链接、标签等知识管理功能
编辑器	VS Code、Sublime Text、vim	通过插件实现语法高亮、实时预览、导出等
转换工具	Pandoc、marked、cmark	将 Markdown 解析并转换为多种输出格式

12.3与开发工作流的联系

```mermaid
flowchart TD
Dev[开发者写代码] --> Doc[用 Markdown 写文档 README / 注释 / PR描述]
Doc --> Git[提交到 Git 仓库]
Git --> CI[CI 自动构建]
CI --> Site[生成文档站点 / 发布到 GitHub Pages]
```

12.4内部语法元素之间的联系

联系	说明	示例
标题与目录	标题级别（`#`、`##`）自动生成文档结构，可生成目录（TOC）	编辑器或静态站点根据标题提取大纲
列表与缩进	通过空格缩进实现嵌套列表，联系了父子关系	`- 一级\n - 二级`
引用与多级引用	`>` 可以嵌套（`>>`），形成多层引用块	回复场景中表示对话深度
代码块与语法高亮	指定语言名（```js）联系到特定高亮规则 \| 提升代码可读性 \|
脚注与引用	正文中的 `[^1]` 与文末的 `[^1]: 注释` 建立双向联系	学术文档中解释术语
链接与锚点	`[链接](#标题)` 可跳转到页面内标题位置	长文档内部导航

12.5与用户思维的联系

所见即所想：Markdown 的设计让用户在构思内容时直接敲出标记，不需要切换鼠标或菜单。
低焦虑：不用担心格式错乱（相比 Word 莫名其妙地改变样式），因为样式由渲染器统一控制。
渐进学习：掌握 20% 的语法（标题、列表、加粗、链接）就能完成 80% 的写作任务，高级功能按需学习。

十三、安全性维度

要点	说明	注意点
XSS 攻击防护	Markdown 允许内嵌 HTML，若解析器不做过滤，恶意脚本可被执行。	渲染前必须对 HTML 标签进行净化（sanitize），或严格禁用 HTML。常用库：DOMPurify、OWASP Java HTML Sanitizer。
链接协议限制	`[点击](javascript:alert('xss'))` 等危险链接可能被某些解析器执行。	解析器应检查链接协议，只允许 `http`、`https`、`mailto` 等安全协议。
图片重定向风险	`![alt](http://evil.com/tracker.png)` 可能泄露用户 IP。	可配置只允许本地或白名单域名，或使用图片代理。
内容注入与篡改	大型平台接受用户输入的 Markdown，存在恶意内容注入风险。	需要配合内容安全策略（CSP）、输出编码、速率限制。

十四、性能与解析效率

维度	说明
解析速度	正则表达式驱动的简单解析器快但不安全；完整语法解析（如 CommonMark）较慢。
大文档处理	超过几 MB 的 Markdown 文档解析可能成为瓶颈，应流式处理或分割。
渲染开销	实时预览编辑器（如 Typora）需高频解析，需优化重绘范围。
缓存策略	相同文档可缓存 AST 或 HTML 结果，避免重复解析。

十五、国际化与本地化（i18n）

注意点	示例/说明
字符编码	始终使用 UTF-8，否则非英文字符（中文、阿拉伯文）可能乱码。
双向文本（Bidi）	希伯来语、阿拉伯语等从右向左的语言需要 HTML 的 `dir` 属性支持，Markdown 本身无此语法。建议内嵌 `<div dir="rtl">`。
列表编号的多语言	中文项目符号（如「一、」）不属于标准 Markdown，需用 HTML 或 CSS 定制。
空格与标点	中文与英文之间建议加空格以获得更好排版，但这通常由渲染器或外部工具处理。

十六、可访问性（a11y）

关注点	Markdown 支持情况	建议
图片替代文本	支持 `![alt](url)`	必须填写有意义的 alt 文本，不可留空。
标题层级连贯性	Markdown 允许任意跳级（如 `#` 后直接 `###`）	建议遵循 `h1` → `h2` → `h3` 的层级，方便屏幕阅读器导航。
链接可辨识	`[点这里](url)` 不友好	链接文本应有描述性（如“查看使用条款”而非“点击”）。
表格结构	简单表格无 `<th>` 作用域	复杂表格应改用 HTML，并标注 `scope="col/row"`。
代码块可读	语言标注用于语法高亮	必须标注语言（```js），便于读屏软件切换发音模式。 \|

十七、标准符合性与兼容性

问题	说明
多方言差异	GFM、CommonMark、原始 Markdown、Pandoc 之间语法行为不一致（如列表后空行、`_` 的语义、嵌套加粗）。
解析器 bug	同一个文档在不同平台（GitHub、GitLab、Obsidian）渲染结果可能不同。
扩展污染	使用了不常见扩展（如 `$` 数学公式）后，文档在普通渲染器中会显示原始符号。
降级方案	尽量只用 CommonMark + GFM 最通用的子集，并测试在纯文本环境下的可读性。

十八、Markdown 工程化与 DevOps

维度	工具/实践
静态分析（Lint）	`markdownlint` 检查语法错误、空白、标题层级、长行等。
自动格式化	`prettier` 可以自动格式化 Markdown，统一团队风格。
测试	对 Markdown 中的链接进行死链检测（`linkchecker`）；对代码块内容执行正确性测试（如 `mdx` 或自定义脚本）。
版本控制差异优化	使用 `.gitattributes` 标记 `*.md diff=markdown` 提升 diff 可读性。
CI/CD 集成	自动构建文档网站、检查 front matter 完整性、触发拼写检查（`codespell`）。

十九、与 AI / LLM 的交互

应用	说明
提示词结构化	LLM（如 ChatGPT）训练数据中大量使用 Markdown，结构化提示（标题、列表、代码块）能提高回答质量。
文档生成	AI 可生成 Markdown 格式的技术文档、PR 描述、周报，便于人类审阅。
解析增强	AI 可修复不规范的 Markdown（如闭合标记、转义遗漏）。
知识库问答	将 Markdown 文档向量化，实现针对文档内容的问答系统。

二十、非技术人群的接受度与替代方案

注意点	应对
学习曲线	部分非技术人员（如市场、法务）对标记语法有抵触。	提供可视化编辑器（如 Markdown 实时预览），或采用 WYSIWYG（如 Notion 的块编辑器）。
协作壁垒	Word 的修订模式在传统企业仍是标准，Markdown 缺乏原生审阅功能。	可结合 CR（代码评审）习惯，或用 Git 的 PR 机制进行文档协作。
替代方案	AsciiDoc、reStructuredText 更适合复杂出版物；纯文本 + 任务管理工具（Trello）可能更简单。	不要强制在所有场景使用 Markdown，评估团队特质。

二十一、Markdown 的未来演进

趋势	说明
标准化	CommonMark 正在成为事实标准，GFM 已是其上扩展。
组件化	MDX（JSX in Markdown）允许引入 React 组件，用于现代文档网站。
富交互	部分实现支持图表、地图、音频录制等自定义块（如 Obsidian 的插件系统）。
原子化	“块引用”与“属性面板”结合，使 Markdown 成为知识图谱的基础存储格式。