Markdown
你可能会说
AI 写的文档里全是 # 和星号，这是什么？能变成好看的排版吗？
Markdown 是用少量排版符号表示标题、列表和代码的结构化纯文本格式例如，# 表示标题、- 表示列表、三个反引号可围住代码块。它适合 README、需求文档、知识库和笔记；需要精确布局、品牌视觉或复杂交互时，通常还要使用 HTML、CSS 和 JavaScript。
也常被叫作Markdown 文档MD 文档Markdown 文件
容易混淆？这样区分
Markdown≠富文本编辑器
Markdown 文档用符号标记标题、加粗和列表，编辑时看到的是纯文本；富文本编辑器会直接显示排版后的效果，更像常见的文档软件。
什么时候用
- 用标题、列表和代码块整理给 AI 的上下文# 需求
- 首页要吸顶导航
- 按钮用蓝色用标题和列表表达需求，便于 AI 识别层级 - 保存 AI 输出的标题、表格、列表和代码块，方便继续处理周末计划
· 周六爬山
· 周日休息许多聊天产品会把 Markdown 风格文本渲染成标题和列表 - 编写 README、需求文档和适合 Git 协作的说明左右分栏，两边同时对照
- 做笔记和知识库：文件轻、不绑定软件，换编辑器或多年以后仍然打得开README.md
# 我的第一个页面
## 运行方法
- npm install纯文本兼容多种编辑器，便于长期保存和查看
什么时候不用
- 未确认目标是否支持 Markdown 就直接粘贴：# 和 ** 可能原样显示，先预览或转成纯文本# 周报 **完成**：首页改版 - 修 bug
- 需要交付 Word 文档时应另行导出或转换，并保留原始 .md 文件W笔记.md → 另存为 笔记.docx转换可能改变 Markdown 结构或转义部分符号
- 不要依赖连续空格或随意换行凑对齐；不同 Markdown 渲染器的折叠规则可能不同价格 ¥199
库存 42 件Markdown 会合并连续空格；请使用表格或列表排版 - 代码块开头写了 ``` 却缺少结尾：后续内容可能被解析为代码块```
npm run dev
下面是正文，却也成了代码缺少结束反引号会使后续内容被解析为代码块
组成结构 · Anatomy
# 周末计划
**周六爬山**，早点出发
- 带水和零食
```npm run dev```
# 表示一级标题，## 表示二级标题；具体字号由渲染器样式决定
用 ** 把字夹住，渲染后变粗；* 一个星号是斜体
- 开头，一行一项；前面加数字就是有序列表
三个反引号上下各一行，中间的内容原样等宽显示
常见变体 · Variants
标题Heading
# 一级标题## 二级标题
按内容层级组织章节；是否只保留一个一级标题由发布规范决定
粗体与列表Bold & List
**重点**- 第一项
强调重点、罗列事项
代码块Code Fence
```npm run dev```
贴命令贴代码，原样等宽显示
链接与图片Link & Image
[文字](网址)
图片比链接多一个叹号
典型使用场景
GitHub README 渲染页
AI 聊天的格式化回答
帮我写个周末计划
周末计划
周六：爬山，记得带水
· 周日在家休息
这个聊天产品把 Markdown 风格文本渲染成了标题、列表和代码
编辑器左右对照写作
Typora / VS Code 预览：左边写符号，右边出效果
目标不支持 Markdown
# 周报 **本周完成**：首页改版 - 修了 3 个 bug
这里的 # 和 ** 没有被解析
聊天框不渲染 Markdown → 先转成纯文本，或直接发截图