Markdown 文档Markdown
网页开发入门用少量符号给纯文本添加结构
也常被叫作MD 文档Markdown 文件
Markdown 用 #、- 和 ** 等简单符号表示标题、列表和强调，即使不预览也能阅读。它适合 README、需求文档、知识库和笔记；需要精确布局、品牌视觉或复杂交互时，应使用 HTML。
SOURCE · 源码
→
# 周末计划
**周六爬山**，早点出发
- 带水和零食
```
npm run dev
```
RENDERED · 渲染后
周末计划
周六爬山，早点出发
带水和零食
npm run dev
容易混淆？这样区分
Markdown 文档Markdown≠富文本编辑器
Markdown 文档用符号标记标题、加粗和列表，编辑时看到的是纯文本；富文本编辑器会直接显示排版后的效果，更像常见的文档软件。
什么时候用
- 用标题、列表和代码块整理给 AI 的上下文# 需求
- 首页要吸顶导航
- 按钮用蓝色用标题和列表写需求，AI 照着结构答 - 保存 AI 输出的标题、表格、列表和代码块，方便继续处理周末计划
· 周六爬山
· 周日休息AI 的回答都是 Markdown 渲染出来的 - 编写 README、需求文档和适合 Git 协作的说明左右分栏，两边同时对照
- 做笔记和知识库：文件轻、不绑定软件，换编辑器或多年以后仍然打得开README.md
# 我的第一个页面
## 怎么运行
- npm install纯文本不挑软件，十年后也打得开
什么时候不用
- 当成富文本直接粘进聊天框：对方看到的是一坨 # 和 *# 周报 **完成**：首页改版 - 修 bug聊天框不渲染，对方看到一坨符号
- 不要把 .md 文件另存为 Word 文档，以免改变原有标记W笔记.md → 另存为 笔记.docx格式全丢，符号还可能被转义
- 在源码里敲空格、回车凑排版：渲染时空格换行会被合并，白费劲价格 ¥199
库存 42 件源码里敲空格凑排版，渲染后全被合并 - 代码块开头写了 ``` 结尾忘了补：后半篇全变成代码```
npm run dev
下面是正文，却也成了代码开头 ``` 没补结尾，后半篇全变代码
组成结构 · Anatomy
# 周末计划
**周六爬山**，早点出发
- 带水和零食
```npm run dev```
1标题标记Heading# 开头，一个 # 一级、两个 # 二级，逐级变小
2粗体标记Bold用 ** 把字夹住，渲染后变粗；* 一个星号是斜体
3列表标记List- 开头，一行一项；前面加数字就是有序列表
4代码块Code Fence三个反引号上下各一行，中间的内容原样等宽显示
常见变体 · Variants
标题Heading
# 一级标题## 二级标题
分章节；一篇只用一个一级标题
粗体与列表Bold & List
**重点**- 第一项
强调重点、罗列事项
代码块Code Fence
```npm run dev```
贴命令贴代码，原样等宽显示
链接与图片Link & Image
[文字](网址)
图片比链接多一个叹号
典型使用场景
GitHub README 渲染页
AI 聊天的格式化回答
帮我写个周末计划
周末计划
周六：爬山，记得带水
· 周日在家休息
AI 吐出来的是 Markdown 源码，聊天框帮你渲染成了这样
编辑器左右对照写作
Typora / VS Code 预览：左边写符号，右边出效果
粘进聊天框翻车了
# 周报 **本周完成**：首页改版 - 修了 3 个 bug
？这一串符号是啥
聊天框不渲染 Markdown → 先转成纯文本，或直接发截图