第四章：让文档更漂亮——表格、图标与进阶排版

4.1 为什么需要好排版？

我们先聊个很简单的问题：为什么要花心思做排版？

你肯定有过这种经历：

打开一篇文章，结果标题和正文挤在一起，一大坨文字密不透风，重要信息和废话混在一起，你扫了一眼，立刻就想关掉。

再打开另一篇，标题清晰，段落松散，重点用加粗标出来，结构一目了然，你不自觉地就想往下读，读完还想收藏起来慢慢看。

这就是排版的力量。排版就是文章的第一印象。

排版的三个核心价值

我总结了三个最实在的好处，你看完就知道为什么要花点时间做好排版了。

1. 提升可读性

密密麻麻一整页文字，没有分段，没有空行，什么都挤在一起。你看着什么感觉？肯定是皱眉头，读两行就累了，哪里还记得住重点在哪里。

如果所有文字都是一个字号，标题跟正文一样大，重点和废话一样粗细，读者找半天找不到你想说什么，耐心很快就磨没了。

好的排版，就是帮读者省力气。标题就是标题，正文就是正文，重点就是重点，读者一眼就能找到他想看的内容。读起来不累，他才会往下读。

2. 提升专业感

我给你看两个例子，你一下子就能感觉出来：

A选手是这样写的：

 这是文档。有一些内容。还有一些更多内容。还有一点重要信息。
 ​
 结论部分：
 1. 结论1
 2. 结论2
 3. 结论3
 ​
 参考资料：
 - 参考1
 - 参考2

B选手是这样写的：

 # 一、问题分析
 ​
 ## 1.1 核心问题
 ### 1.1.1 具体表现
 ### 1.1.2 数据表现
 ​
 ## 1.2 解决方案
 ### 1.2.1 方案一
 ### 1.2.2 方案二
 ​
 ## 1.3 实施步骤
 ### 1.3.1 步骤一
 ### 1.3.2 步骤二
 ​
 ## 1.4 预期效果
 ​
 ## 二、参考资料
 - [1] 文献1
 - [2] 文献2

你更愿意读哪一个？显然是B对吧？

层次清楚，结构分明，哪怕内容一样，读者也会觉得”哦，这个人做事很专业”。第一印象分一下子就上去了。

3. 提升分享效果

排版舒服的文章，读者更容易理解你想说什么，也更愿意转发分享给别人。分享的人多了，自然能获得更多点赞收藏，也能慢慢建立你的个人品牌。

实际场景对比，一眼就能看出差别

我拿两个日常场景给你对比一下，你就明白好排版差在哪了。

场景1：写一篇技术博客

没有排版的写法，所有内容堆在一起：

 Markdown学习心得
 ​
 今天开始学习Markdown，感觉还不错。支持加粗、斜体，也支持列表。接下来要学习表格、引用、代码块等内容。希望能掌握好这个工具，写文档会更方便。AI时代，Markdown的重要性越来越明显，很多技术社区都在用。

做好排版的写法，结构一目了然：

 # Markdown学习心得
 ​
 今天开始学习**Markdown**，感觉还不错！
 ​
 ## 为什么选择 Markdown？
 ​
 ### 相比 Word 的优势
 ​
 | 功能 | Word | Markdown |
 |------|------|----------|
 | 学习难度 | 复杂 | 简单 ✅ |
 | 文件大小 | 大 | 小 ✅ |
 | 版本控制 | 困难 | 简单 ✅ |
 ​
 ### 实际应用
 ​
 1. 写博客文章
 2. 记学习笔记
 3. 写技术文档
 ​
 ## 学习内容
 ​
 ### 基础语法
 - 标题和段落
 - 文本格式（加粗、斜体）
 - 列表（无序、有序）
 - 代码块
 ​
 ### 进阶技巧
 - 表格制作
 - 图片插入
 - 链接和引用
 ​
 ## 练习任务
 - [x] 完成基础语法学习
 - [ ] 尝试表格制作
 - [ ] 写一篇博客文章
 ​
 ---
 ​
 加油！坚持学习！

哪个更容易理解？哪个你更愿意分享给朋友？不用我说你也能感觉到。

场景2：做学习笔记

没有排版，一大坨文字堆着：

 今天学习了Markdown，感觉还不错，支持加粗、斜体，也支持列表，接下来要学习表格、引用、代码块等内容，希望能掌握好这个工具，写文档会更方便，AI时代，Markdown的重要性越来越明显，很多技术社区都在用。

做好排版，层次清清楚楚：

 # Markdown 学习笔记
 ​
 ## 今天的学习内容
 ​
 ### 基础语法
 - 标题和段落 ✅
 - 文本格式（加粗、斜体） ✅
 ​
 ### 实战练习
 - 代码示例
 - 使用技巧
 ​
 ## 下一步计划
 - [ ] 学习表格
 - [ ] 学习引用
 - [ ] 尝试写一篇文章

你考前复习的时候，哪个更容易找到重点？肯定是第二个吧？

几个最简单的排版小技巧

其实不用学什么复杂的设计理论，记住这几招，你的排版立刻就能好看很多。

学会视觉分层

用空行分段 —— 一个意思说完了，就空一行。别舍不得，让文章”会呼吸”，读者读着才不累。

用标题分层 —— 一级标题是文章主题，二级标题是主要章节，三级标题是具体小节。别跳级，结构就不会乱。

重点要突出

重要内容，用加粗标出来。提醒读者注意的地方，用引用块放进去。读者扫一眼，就能抓住重点。

要点用列表整理

一堆要点挤在段落里，读者看着累。把要点一条一条列出来，一目了然，读起来轻松多了。

快速检查清单

看完这一节，你可以打开你现在写的文章，对着这个清单检查一下：

  • 标题清晰吗？
  • 段落分开了吗？
  • 重点突出了吗？
  • 有清晰的视觉层级吗？
  • 读起来轻松吗？

如果大部分都是✅，那你的排版已经很不错了。

如果有很多❌，那接下来这一章，我们就来学习各种进阶排版技巧，学好了，你的文章立刻就能焕然一新。

4.2 表格制作：从简单到精美

上一节我们说了排版为什么重要，这一节学一个超级实用的进阶技能——做表格。

学会做表格，你的文档专业度一下子就能提升一个档次。有些数据，用表格放着，比你写十段话都清楚。

最简单的表格，两分钟就能做

Markdown做表格真的不难。记住一句话：用竖线 | 分隔列，用横线 - 分隔表头和内容。

就是这么简单：

 | 姓名 | 年龄 |
 |------|------|
 | 张三 | 25 |
 | 李四 | 30 |

出来效果就是这样：

姓名年龄
张三25
李四30

讲几个新手一定要记住的点：

  • 第一行永远是表头，就是每一列叫什么名字
  • 第二行一定要用横线分隔，这是Markdown要求的
  • 第三行开始才是你的数据
  • 最重要：表头有几列，每一行数据就得有几列，不能多不能少，不然显示会错

其实你哪怕不对齐，Markdown也能识别。比如你写成这样：

 | 姓名 | 年龄 |
 |--|--|
 | 张三 | 25 |
 | 李四 | 30 |

出来效果一模一样。但是你自己写的时候，手动对齐一下，看着舒服，后面改也方便。

控制对齐方式，让表格更好看

你还可以控制每一列内容的对齐方式，很简单，就在横线那里加冒号：

  • 左对齐：|--- （冒号在左边）
  • 居中对齐：|:---:| （冒号在两边）
  • 右对齐：|---: （冒号在右边）

我给你举个例子，一看就懂：

 | 名称（左对齐） | 价格（居中） | 库存（右对齐） |
 |:-----|:----:|-------:|
 | 苹果 | 5.8元 | 100 |
 | 香蕉 | 3.5元 | 200 |

效果：

名称（左对齐）价格（居中）库存（右对齐）
苹果5.8元100
香蕉3.5元200

给你一个实用经验：

  • 文字内容一般左对齐，看着舒服
  • 标题、表头居中好看
  • 数字、价格一定要右对齐，这样尾数对齐，比大小一眼就能看出来

就这么简单，照着用就行了。

表格里也能加粗、加链接

你在正文中会的格式，表格里一样能用。

比如给重要内容加粗：

 | 学习内容 | 重要程度 |
 |:-----------|-------:|
 | **Markdown基础语法** | ⭐⭐⭐⭐⭐ |
 | 表格制作 | ⭐⭐⭐ |
 | 图片插入 | ⭐⭐ |

效果：

学习内容重要程度
Markdown基础语法⭐⭐⭐⭐⭐
表格制作⭐⭐⭐
图片插入⭐⭐

你也可以加链接，和正文用法一模一样：

 | 学习资源 | 地址 |
 |:-----------|-------:|
 | 掘金社区 | [点击进入](https://juejin.cn) |
 | 语雀文档 | [点击进入](https://www.yuque.com) |

效果：

学习资源地址
掘金社区点击进入
语雀文档点击进入

所以你看，表格没什么新东西，就是把你已经会的格式放到格子里而已。

三个实战案例，拿过去就能用

我给你准备了三个最常用的表格案例，你直接照着改改就能用。

案例一：周计划

做每周计划，用表格太清楚了：

 | 星期 | 任务 | 优先级 | 状态 |
 |:-----|:------|:---------|:-------:|
 | 周一 | 学习Markdown基础 | 🔴 高优先 | ✅ 已完成 |
 | 周二 | 完成表格练习 | 🔴 高优先 | 🔄 进行中 |
 | 周三 | 学习图片插入 | 🟡 中优先 | ⏳ 待开始 |
 | 周四 | 写一篇实战文章 | 🟢 低优先 | ⏳ 待开始 |
 | 周五 | 复习总结 | 🟢 低优先 | ⏳ 待开始 |

效果：

星期任务优先级状态
周一学习Markdown基础🔴 高优先✅ 已完成
周二完成表格练习🔴 高优先🔄 进行中
周三学习图片插入🟡 中优先⏳ 待开始
周四写一篇实战文章🟢 低优先⏳ 待开始
周五复习总结🟢 低优先⏳ 待开始

用Emoji标记优先级和状态，一眼就能看清楚本周进度，比你写一大段文字清楚多了。

案例二：购物清单

 | 商品 | 数量 | 单价 | 小计 | 购买状态 |
 |:-----|:-------|:------|:------|:----------|
 | 苹果 | 5个 | 5.8元 | 29元 | [ ] 待购买 |
 | 牛奶 | 2盒 | 25元 | 50元 | [ ] 待购买 |
 | 面包 | 1袋 | 10元 | 10元 | [x] 已购买 |
 | 青菜 | 3斤 | 3元 | 9元 | [ ] 待购买 |

效果：

商品数量单价小计购买状态
苹果5个5.8元29元[ ] 待购买
牛奶2盒25元50元[ ] 待购买
面包1袋10元10元[x] 已购买
青菜3斤3元9元[ ] 待购买

出门购物前，打开看看，买一个勾一个，不会漏买东西，还能控制预算，特别实用。

案例三：课程表

 | 星期 | 课程 | 时间 | 教室 | 老师 |
 |:-----|:---------|:------:|:-----|:-------|
 | 周一 | Markdown基础 | 9:00-10:30 | A101 | 张老师 |
 | 周二 | 表格制作 | 10:30-12:00 | A101 | 李老师 |
 | 周三 | 进阶排版 | 14:00-15:30 | B202 | 王老师 |
 | 周四 | 图片链接 | 15:30-17:00 | B202 | 赵老师 |
 | 周五 | 综合练习 | 19:00-20:30 | A101 | 周老师 |

效果：

星期课程时间教室老师
周一Markdown基础9:00-10:30A101张老师
周二表格制作10:30-12:00A101李老师
周三进阶排版14:00-15:30B202王老师
周四图片链接15:30-17:00B202赵老师
周五综合练习19:00-20:30A101周老师

信息全，看着清楚，存在手机里，随时打开就能看。

给新手的几个小提醒

最后说几个新手容易犯的错，你避开就好了：

第一，列数别太多

一列放一个信息就够了，别贪多。一般一个表格不要超过五列，列太多了显示不开，会换行，看着特别乱。

第二，对齐方式要统一

同一列对齐方式要一样，别这一行左对齐，下一行居中，看着特别乱。数字就统一右对齐，文字就统一左对齐。

第三，重要内容可以加粗

表格空间有限，把最重要的信息加粗，读者一眼就能抓到重点。

4.3 图标使用：让文档更生动

上一节我们学会了做表格，这一节学一个能让你的文章一下子”活”起来的小技巧——用图标。

图标就像是文章的调料，放对了，整道菜一下子就有味道了。学会了，你的文档会比纯文字生动很多，读者也更愿意读下去。

最简单的方式：直接用 Emoji

Emoji 就是我们平时在微信聊天里用的那些表情符号，😊 😂 ⭐ ✅ 这些都是。

在 Markdown 里用 Emoji 真的超级简单——你直接复制粘贴进去就行，什么都不用管。

 # 今天心情不错 😊
 ​
 学习 Markdown 很开心！🎉
 ​
 我推荐这个工具 ⭐⭐⭐⭐⭐
 ​
 注意：这是一个重要提示 ⚠️
 ​
 这一步完成啦！✅

效果就是这样，直接就能显示：

今天心情不错 😊

学习 Markdown 很开心！🎉

我推荐这个工具 ⭐⭐⭐⭐⭐

注意：这是一个重要提示 ⚠️

这一步完成啦！✅

现在几乎所有 Markdown 工具都支持 Emoji，掘金、知乎、语雀、飞书、Typora、GitHub，全都没问题。你放心用就行。

常用 Emoji 分类整理，收藏这页就够了

我给你整理了最常用的，按分好类，你需要的时候直接来找：

状态类（最常用）

  • ✅ 完成 / ❌ 错误 / ⚠️ 警告
  • 📝 笔记 / 🎯 目标 / 📌 标记
  • 🔥 热门 / 💡 想法 / ❓ 疑问

星级评分

  • ⭐ 一颗星 / ⭐⭐⭐⭐⭐ 五颗满分

分类用途

  • 📚 学习 / 💼 工作 / 🏠 生活
  • 🎮 娱乐 / 💰 财务 / 🏥 健康

进度状态

  • 🔄 进行中 / ⏳ 等待中 / ⏸️ 暂停

优先级标记

  • 🔴 高优先 / 🟡 中优先 / 🟢 低优先

Emoji 最常用在这些地方

放在标题里，一眼就能看出这一章讲什么

 # 第一章：Markdown 入门 📚
 ## 1.1 为什么选择 Markdown？🤔
 ## 1.2 Markdown vs Word ⚔️
 ## 小结 ✅

放在列表里，状态一目了然

 今天完成了这些内容：
 - ✅ 标题和段落
 - ✅ 文本格式（加粗、斜体）
 - ✅ 列表（无序、有序）
 - [ ] 表格制作
 - [ ] 图片插入

放在表格里，信息更清晰

 | 学习内容 | 状态 | 优先级 |
 |:-----------|:-------|:----------|
 | Markdown 基础 | ✅ 已完成 | 🔴 高优先 |
 | 表格制作 | 🔄 进行中 | 🟡 中优先 |
 | 图片插入 | ⏳ 待开始 | 🟢 低优先 |

给新手的两个使用建议

第一，别用太多

一个标题加一两个 Emoji 就够了，别每个词都加，那样页面会很乱，看着累。适量才好看。

第二，保持一致

同样的意思，用同样的 Emoji。比如完成都用 ✅，就别一会儿 ✅ 一会儿 ✓，换来换去读者看着晕。

纯文本符号：任何平台都能用

除了 Emoji，你还可以用纯文本符号做图标，好处是任何平台都能显示，不会出问题。

我给你整理一些最常用的：

箭头符号

 → 向右箭头（表示步骤顺序特别好用）
 ← 向左箭头
 ↑ 向上箭头
 ↓ 向下箭头

特殊符号

 ✓ 对号（打勾）
 ✗ 叉号（打叉）
 ★ 实心星星
 ☆ 空心星星
 ❗ 感叹号（提示用）
 ❓ 问号（疑问用）

几何符号

 ■ 实心方块
 □ 空心方块
 ● 实心圆形
 ○ 空心圆形
 ▲ 上三角形
 ▼ 下三角形

数字序号

 ① ② ③ ④ ⑤ ，比单纯写 1. 2. 3. 好看多了

这些符号怎么用？给你看几个实际例子：

表示步骤顺序

安装步骤：
Step 1: 下载安装包 →
Step 2: 解压缩 →
Step 3: 运行安装程序 →
Step 4: 完成设置 ✓

表示进度

学习进度：
① Markdown 基础 ─────── 100%
② 表格制作 ──────── 80%
③ 图标使用 ──────── 40%
④ 特殊元素 ──────── 0%

表示优先级

任务优先级：
■■■■■ 高优先级
■■■□□ 中优先级
■□□□□ 低优先级

就这么简单，用这些纯文本符号，也能做出很好看的视觉效果。

实用组合技巧，拿过去就能用

我整理了几个最常用的图标组合方案，你直接照着用就行。

任务状态

这个真的天天用，记下来：

✅ 已完成
🔄 进行中
⏳ 待开始
⏸️ 已暂停
❌ 已取消

提示类型

不同类型的内容用不同图标，读者一眼就能分清：

📝 笔记：记录重要信息
💡 想法：新想法和创意
⚠️ 警告：需要注意的问题
❓ 疑问：不确定的内容
🎯 目标：想要达成的目标
📌 标记：重点内容标记

优先级

做项目管理、时间管理，这个特别好用：

🔴 高优先级（紧急重要，马上要做）
- 今天必须完成的任务

🟡 中优先级（重要不紧急）
- 本周需要完成

🟢 低优先级（可以延后）
- 有空再做

内容分类

给笔记分类，用图标比文字还清楚：

我的笔记：

📚 学习笔记
- Markdown 学习心得
- Python 入门笔记

💼 工作笔记
- 项目会议记录
- 工作流程文档

🏠 生活笔记
- 购物清单
- 旅行计划

时间标记

用图标表示时间，一目了然：

📅 今天：3月16日
📆 本周：3月16日-3月22日
🗓️ 本月：2026年3月

⏰ 任务时间：14:00-16:00
⌛ 截止时间：2026年3月20日

评分系统

给书籍、工具评分，星星最直观：

书籍评分：

《深入浅出Node.js》 ⭐⭐⭐⭐⭐ (5/5)
《JavaScript 高级程序设计》 ⭐⭐⭐⭐⭐ (5/5)
《你不知道的 JavaScript》 ⭐⭐⭐⭐ (4/5)

工具推荐：

Typora ⭐⭐⭐⭐⭐
语雀 ⭐⭐⭐⭐
掘金 ⭐⭐⭐⭐⭐

实战案例，看看完整的用法

我给你看几个完整的实际案例，你就能感受到用了图标和不用图标差别有多大。

案例一：学习计划

# Markdown 学习计划 📚

## 📅 学习时间表

| 周期 | 学习内容 | 优先级 | 状态 |
|:-----|:---------|:----------|:-------|
| 周一 | Markdown 基础语法 | 🔴 高 | ✅ 已完成 |
| 周二 | 表格制作 | 🔴 高 | ✅ 已完成 |
| 周三 | 图标使用 | 🟡 中 | 🔄 进行中 |
| 周四 | 图片链接 | 🟡 中 | ⏳ 待开始 |
| 周五 | 高阶技巧 | 🟢 低 | ⏳ 待开始 |

## 🎯 学习目标

- [x] 理解基本概念
- [x] 掌握基础语法
- [x] 学会表格制作
- [ ] 学会图标使用
- [ ] 写完一篇完整文章

## ⚠️ 注意事项

- 不要过度使用图标
- 保持用法一致
- 选对图标比多放图标重要

---

加油，继续学习！💪

你看，是不是结构清楚，看着也舒服？

案例二：读书笔记

# 《深入浅出 Node.js》读书笔记 📖

## 📚 书籍信息

- **书名**：深入浅出 Node.js
- **作者**：朴灵
- **评分**：⭐⭐⭐⭐⭐ (5/5)
- **状态**：🔄 阅读中
- **进度**：第3章 / 共6章 (50%)

## 🎯 阅读目标

- [x] 第一章 介绍 -> 完成
- [x] 第二章 核心模块 -> 完成
- [ ] 第三章 异步编程 -> 进行中
- [ ] 第四章 网络编程 -> 待开始
- [ ] 第五章 进程管理 -> 待开始
- [ ] 第六章 调试 -> 待开始

## 📝 第三章笔记

### 核心内容
- 异步编程的几种方式
- 回调函数的原理

### 💡 重点理解
- 异步和同步的区别
- 回调不是坏事，控制好回调地狱

### ❓ 还没懂的问题
- Promise 到底怎么用？
- async/await 最佳实践

## 🏷️ 知识标签

- 🔧 Node.js
- 💻 JavaScript
- ⚙️ 后端开发

---

继续阅读！💪

这样记笔记，几个月后你再看，一下子就能找到重点，比纯文字好用太多了。

4.4 链接、图片与代码块进阶

上一节我们学会了用图标让文章更生动，这一节学习三个文章里必不可少的元素——链接、图片和代码块进阶用法。

学会这些，你的文章就能放参考资料、放截图、放代码，真正完整了。

链接：让文档连起来

链接就是你点击文字，能跳转到别的网页或者文档里别的位置。这是互联网的基础功能，Markdown 支持得很好。

基础链接，一分钟学会

链接语法真的很简单，就是这样：

 [显示给读者看的文字](链接地址)

方括号放文字，圆括号放网址。就这么记。

举个例子：

 欢迎去[掘金](https://juejin.cn)学习技术文章
 想整理笔记可以用[语雀](https://www.yuque.com)
 代码存在[GitHub](https://github.com)

效果就是这样，点一下文字就能跳过去：

欢迎去掘金学习技术文章 想整理笔记可以用语雀 代码存在GitHub

你还可以给链接加个标题，鼠标悬停在链接上会显示：

 [掘金](https://juejin.cn "掘金社区 - 中国领先的开发者社区")

这个不常用，知道有这么回事就行。

给新手一个重要建议

链接文字要写得有意义。别这么写：

❌ 不好：点击这里 访问掘金

✅ 好：访问 掘金 学习技术文章

读者扫一眼就知道点过去会看到什么，体验好很多。

链接到本地文档，方便做电子书

如果你把很多 Markdown 文件放在一起做电子书或者笔记，可以用相对路径链接：

假设你的文件结构是这样：

 book/
 ├── README.md
 ├── chapter1.md
 └── chapter2.md

在 README.md 里你可以这么写：

 - [第一章：Markdown 入门](chapter1.md)
 - [第二章：基础语法](chapter2.md)

点开就能直接跳到对应的文件，特别方便做电子书。

文档内跳转，做目录很方便

如果你写了一篇很长的文章，可以做个目录，点击目录标题直接跳到对应的章节，这就是锚点链接。

用法也很简单：

 ## 目录
 ​
 - [第一章：为什么学](#为什么学)
 - [第二章：怎么入门](#怎么入门)
 - [第三章：工具推荐](#工具推荐)
 ​
 ---
 ​
 ## 第一章：为什么学 {: #为什么学 }
 ​
 这里是第一章内容...
 ​
 ## 第二章：怎么入门 {: #怎么入门 }
 ​
 这里是第二章内容...
 ​
 [回到目录](#目录)

就是在标题后面加上 {: #锚点名字}，然后链接里写 #锚点名字 就能跳过去了。做目录、页内跳转都特别方便。

插入图片，让文章图文并茂

想要文章生动，肯定少不了图片。Markdown 插入图片也很简单。

基础语法，比链接多一个感叹号

图片语法和链接很像，就是前面多一个感叹号 !：

 ![图片说明文字](图片地址)

那个说明文字，图片加载不出来的时候会显示，搜索引擎也能读到，最好加上。

如果是网络图片，直接放图片网址就行：

 ![Markdown Logo](https://markdown-here.com/img/icon256.png)

效果就是这样：

Markdown Logo

如果是你自己电脑上的本地图片，放对路径就行：

![我的截图](images/screenshot.png)

路径和链接一样，同一文件夹直接写文件名，子文件夹就写 文件夹/文件名.png。

想控制图片大小？这么做

标准 Markdown 不支持改图片大小，但是大部分常用工具都支持扩展写法。我给你整理几个常用工具的用法：

Typora（最常用）

![图片](地址 =600x400)

宽 600，高 400，只写宽度就是 =600x，自动按比例缩放。

语雀

![图片](地址 =600x)

和 Typora 差不多，够用了。

通用方法（大部分工具都支持） 直接用 HTML：

<img src="图片地址" width="600" />

写上宽度，高度自动按比例缩，这个兼容性最好。

给图片加说明，更专业

你看技术书里，图片下面都有说明。Markdown 这么做：

![系统架构图](images/architecture.png)

*图 1：系统整体架构图*

就是图片放完，空一行，用斜体放说明，读着很清楚。

如果你想让图片居中，大部分工具支持 HTML 写法：

<center>
  ![系统架构图](images/architecture.png)
  <br>
  <small>图 1：系统整体架构图</small>
</center>

这样图片就居中了，说明也在下面，看着很专业。

高阶技巧：点击图片看大图

如果你有一张大图，想放个小图缩略，点开看大图，可以这么写：

[![点击查看大图](images/thumb.png)](images/large.png)

就是把图片放在链接里面，点开缩略图就能看大图。特别适合放截图、照片。

给新手几个实用建议

格式选择：

  • PNG 适合截图、图标，背景透明
  • JPG 适合照片，文件小
  • GIF 适合动图

大小优化：

  • 不要直接上传原图，太大了加载慢
  • 截图适当压缩，够用就行
  • 网络图片确保地址稳定，别过两个月链接失效了

代码块进阶，更好展示代码

第二章我们学过基础的代码块，这一节说几个进阶技巧，让你的代码块更好看。

语法高亮，这个一定要开

代码块开头三个反引号后面写上编程语言名字，工具就能给你做语法高亮，关键字会变色，读着舒服多了。

比如 JavaScript：

function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet('World'));

Python 就是这样：

def greet(name):
    return f"Hello, {name}!"

print(greet("World"));

是不是比没高亮好看多了？所以记住：一定要写语言名称。

我给你整理了最常用的语言标识：

语言标识什么时候用
JavaScriptjavascript 或 js网页前端
Pythonpython 或 pyPython 代码
JavajavaJava 代码
HTMLhtml网页代码
CSScss样式代码
SQLsql数据库查询
Bashbash 或 sh终端命令
JSONjson数据格式
Markdownmarkdown 或 mdMarkdown 示例

就这些，够用了。

代码块要注意这些细节

第一，别太长

一大屏代码，读者看着累。如果代码很长，分成几块放，或者只放关键部分，不全贴。

第二，一定要加说明

放代码之前，说说这段代码是干嘛的，放完之后，可以讲讲关键部分什么意思。别扔一大块代码在那就不管了。

第三，高亮关键行

有些工具支持高亮某几行代码，比如 GitHub、Typora 都支持，把重点行标出来，读者一眼就能看到：

function greet(name) {
  // 这一行是重点
  return `Hello, ${name}!`;
}

这个不是标准功能，但有的工具支持，用上体验更好。

4.4 链接、图片与代码块进阶

上一节我们学会了用图标让文章更生动，这一节学习三个文章里必不可少的元素——链接、图片和代码块进阶用法。

学会这些，你的文章就能放参考资料、放截图、放代码，真正完整了。

链接：让文档连起来

链接就是你点击文字，能跳转到别的网页或者文档里别的位置。这是互联网的基础功能，Markdown 支持得很好。

基础链接，一分钟学会

链接语法真的很简单，就是这样：

 [显示给读者看的文字](链接地址)

方括号放文字，圆括号放网址。就这么记。

举个例子：

 欢迎去[掘金](https://juejin.cn)学习技术文章
 想整理笔记可以用[语雀](https://www.yuque.com)
 代码存在[GitHub](https://github.com)

效果就是这样，点一下文字就能跳过去：

欢迎去掘金学习技术文章 想整理笔记可以用语雀 代码存在GitHub

你还可以给链接加个标题，鼠标悬停在链接上会显示：

 [掘金](https://juejin.cn "掘金社区 - 中国领先的开发者社区")

这个不常用，知道有这么回事就行。

给新手一个重要建议

链接文字要写得有意义。别这么写：

❌ 不好：点击这里 访问掘金

✅ 好：访问 掘金 学习技术文章

读者扫一眼就知道点过去会看到什么，体验好很多。

链接到本地文档，方便做电子书

如果你把很多 Markdown 文件放在一起做电子书或者笔记，可以用相对路径链接：

假设你的文件结构是这样：

 book/
 ├── README.md
 ├── chapter1.md
 └── chapter2.md

在 README.md 里你可以这么写：

 - [第一章：Markdown 入门](chapter1.md)
 - [第二章：基础语法](chapter2.md)

点开就能直接跳到对应的文件，特别方便做电子书。

文档内跳转，做目录很方便

如果你写了一篇很长的文章，可以做个目录，点击目录标题直接跳到对应的章节，这就是锚点链接。

用法也很简单：

 ## 目录
 ​
 - [第一章：为什么学](#为什么学)
 - [第二章：怎么入门](#怎么入门)
 - [第三章：工具推荐](#工具推荐)
 ​
 ---
 ​
 ## 第一章：为什么学 {: #为什么学 }
 ​
 这里是第一章内容...
 ​
 ## 第二章：怎么入门 {: #怎么入门 }
 ​
 这里是第二章内容...
 ​
 [回到目录](#目录)

就是在标题后面加上 {: #锚点名字}，然后链接里写 #锚点名字 就能跳过去了。做目录、页内跳转都特别方便。

插入图片，让文章图文并茂

想要文章生动，肯定少不了图片。Markdown 插入图片也很简单。

基础语法，比链接多一个感叹号

图片语法和链接很像，就是前面多一个感叹号 !：

 ![图片说明文字](图片地址)

那个说明文字，图片加载不出来的时候会显示，搜索引擎也能读到，最好加上。

如果是网络图片，直接放图片网址就行：

 ![Markdown Logo](https://markdown-here.com/img/icon256.png)

效果就是这样：

Markdown Logo

如果是你自己电脑上的本地图片，放对路径就行：

![我的截图](images/screenshot.png)

路径和链接一样，同一文件夹直接写文件名，子文件夹就写 文件夹/文件名.png。

想控制图片大小？这么做

标准 Markdown 不支持改图片大小，但是大部分常用工具都支持扩展写法。我给你整理几个常用工具的用法：

Typora（最常用）

![图片](地址 =600x400)

宽 600，高 400，只写宽度就是 =600x，自动按比例缩放。

语雀

![图片](地址 =600x)

和 Typora 差不多，够用了。

通用方法（大部分工具都支持） 直接用 HTML：

<img src="图片地址" width="600" />

写上宽度，高度自动按比例缩，这个兼容性最好。

给图片加说明，更专业

你看技术书里，图片下面都有说明。Markdown 这么做：

![系统架构图](images/architecture.png)

*图 1：系统整体架构图*

就是图片放完，空一行，用斜体放说明，读着很清楚。

如果你想让图片居中，大部分工具支持 HTML 写法：

<center>
  ![系统架构图](images/architecture.png)
  <br>
  <small>图 1：系统整体架构图</small>
</center>

这样图片就居中了，说明也在下面，看着很专业。

高阶技巧：点击图片看大图

如果你有一张大图，想放个小图缩略，点开看大图，可以这么写：

[![点击查看大图](images/thumb.png)](images/large.png)

就是把图片放在链接里面，点开缩略图就能看大图。特别适合放截图、照片。

给新手几个实用建议

格式选择：

  • PNG 适合截图、图标，背景透明
  • JPG 适合照片，文件小
  • GIF 适合动图

大小优化：

  • 不要直接上传原图，太大了加载慢
  • 截图适当压缩，够用就行
  • 网络图片确保地址稳定，别过两个月链接失效了

代码块进阶，更好展示代码

第二章我们学过基础的代码块，这一节说几个进阶技巧，让你的代码块更好看。

语法高亮，这个一定要开

代码块开头三个反引号后面写上编程语言名字，工具就能给你做语法高亮，关键字会变色，读着舒服多了。

比如 JavaScript：

function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet('World'));

Python 就是这样：

def greet(name):
    return f"Hello, {name}!"

print(greet("World"));

是不是比没高亮好看多了？所以记住：一定要写语言名称。

我给你整理了最常用的语言标识：

语言标识什么时候用
JavaScriptjavascript 或 js网页前端
Pythonpython 或 pyPython 代码
JavajavaJava 代码
HTMLhtml网页代码
CSScss样式代码
SQLsql数据库查询
Bashbash 或 sh终端命令
JSONjson数据格式
Markdownmarkdown 或 mdMarkdown 示例

就这些，够用了。

代码块要注意这些细节

第一，别太长

一大屏代码，读者看着累。如果代码很长，分成几块放，或者只放关键部分，不全贴。

第二，一定要加说明

放代码之前，说说这段代码是干嘛的，放完之后，可以讲讲关键部分什么意思。别扔一大块代码在那就不管了。

第三，高亮关键行

有些工具支持高亮某几行代码，比如 GitHub、Typora 都支持，把重点行标出来，读者一眼就能看到：

function greet(name) {
  // 这一行是重点
  return `Hello, ${name}!`;
}

这个不是标准功能，但有的工具支持，用上体验更好。

4.6 实战案例集：看完整例子，上手更快

前面我们把进阶排版技巧一个个都学完了，这一节给你准备好了几个完整的实战案例，都是日常写作最常用的。你直接照着改改就能用。

案例一：个人简历

基础版（简洁风）

如果你 just want a simple resume，这么写就够了：

 # 个人简历
 ​
 ## 基本信息
 ​
 - 姓名：张三
 - 性别：男
 - 年龄：25
 - 电话：138-1234-5678
 - 邮箱：zhangsan@email.com
 - 地址：北京市朝阳区
 ​
 ## 教育背景
 ​
 ### 本科
 - 学校：北京大学
 - 专业：计算机科学与技术
 - 时间：2016-2020
 - 学历：本科
 ​
 ## 工作经验
 ​
 ### 软件工程师
 - 公司：某互联网公司
 - 时间：2020-2023
 - 职责：
   - 负责后端开发
   - 参与系统设计
   - 代码审查
 ​
 ## 技能
 ​
 - 编程语言：Python、Java、JavaScript
 - 框架：Django、Spring Boot、React
 - 数据库：MySQL、MongoDB
 - 工具：Git、Docker、Linux
 ​
 ## 项目经验
 ​
 ### 在线教育平台
 - 时间：2022-2023
 - 职责：后端开发
 - 技术栈：Python、Django、MySQL
 - 成果：服务10万+用户
 ​
 ## 自我评价
 ​
 本人认真负责，热爱技术，有良好的团队协作能力。

特点：简洁明了，结构清晰，信息完整，什么工具都能显示，不会出问题。

高阶版（美化版，用图标+表格）

想要更好看一点，用这个版本：

 # 个人简历 📄
 ​
 ## 👤 基本信息
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 📛 姓名 | 张三 |
 | 👤 性别 | 男 |
 | 🎂 年龄 | 25 |
 | 📞 电话 | 138-1234-5678 |
 | 📧 邮箱 | zhangsan@email.com |
 | 📍 地址 | 北京市朝阳区 |
 ​
 ## 🎓 教育背景
 ​
 ### 本科学位
 | 项目 | 内容 |
 |:-----|:-----|
 | 🏫 学校 | 北京大学 |
 | 📚 专业 | 计算机科学与技术 |
 | 📅 时间 | 2016-2020 |
 | 🎓 学历 | 本科 |
 ​
 ## 💼 工作经验
 ​
 ### 软件工程师 ⭐⭐⭐⭐⭐
 | 项目 | 内容 |
 |:-----|:-----|
 | 🏢 公司 | 某互联网公司 |
 | 📅 时间 | 2020-2023 |
 | 📋 职责 | - 负责后端开发<br>- 参与系统设计<br>- 代码审查 |
 ​
 ## 🔧 技能
 ​
 | 类别 | 技能 |
 |:-----|:-----|
 | 💻 编程语言 | Python、Java、JavaScript |
 | 🧩 框架 | Django、Spring Boot、React |
 | 🗄️ 数据库 | MySQL、MongoDB |
 | 🛠️ 工具 | Git、Docker、Linux |
 ​
 ## 🚀 项目经验
 ​
 ### 在线教育平台 ⭐⭐⭐⭐⭐
 | 项目 | 内容 |
 |:-----|:-----|
 | 📅 时间 | 2022-2023 |
 | 👔 职责 | 后端开发 |
 | 💡 技术栈 | Python、Django、MySQL |
 | 🏆 成果 | 服务10万+用户 |
 ​
 ## 📝 自我评价
 ​
 本人认真负责，热爱技术，有良好的团队协作能力。✅
 ​
 ---
 ​
 *感谢您的阅读！* 🙏

特点：用图标做装饰，信息放表格里更整齐，看起来更专业，HR看着舒服。

案例二：周计划

基础版

简单直接，适合自己看：

 # 本周计划
 ​
 ## 周一
 ​
 - 学习：完成Markdown基础
 - 工作：完成项目文档
 - 生活：健身1小时
 ​
 ## 周二
 ​
 - 学习：学习表格制作
 - 工作：参加团队会议
 - 生活：阅读30分钟
 ​
 ## 周三
 ​
 - 学习：学习图标使用
 - 工作：代码审查
 - 生活：看电影
 ​
 ## 周四
 ​
 - 学习：学习特殊元素
 - 工作：修复Bug
 - 生活：整理房间
 ​
 ## 周五
 ​
 - 学习：总结学习成果
 - 工作：周报汇报
 - 生活：和朋友聚餐
 ​
 ## 周六
 ​
 - 学习：复习本周内容
 - 工作：休息
 - 生活：户外活动
 ​
 ## 周日
 ​
 - 学习：下周计划
 - 工作：休息
 - 生活：家庭时间

高阶版（用表格+图标，一目了然）

 # 本周计划 📅
 ​
 | 日期 | 学习任务 | 工作任务 | 生活安排 | 优先级 | 状态 |
 |:-----|:---------|:---------|:---------|:-------|:-------|
 | 周一 | Markdown基础 | 项目文档 | 健身1小时 | 🔴 高 | ✅ 完成 |
 | 周二 | 表格制作 | 团队会议 | 阅读30分钟 | 🔴 高 | ✅ 完成 |
 | 周三 | 图标使用 | 代码审查 | 看电影 | 🟡 中 | 🔄 进行中 |
 | 周四 | 特殊元素 | 修复Bug | 整理房间 | 🟡 中 | ⏳ 待开始 |
 | 周五 | 学习总结 | 周报汇报 | 朋友聚餐 | 🟡 中 | ⏳ 待开始 |
 | 周六 | 复习内容 | 休息 | 户外活动 | 🟢 低 | ⏳ 待开始 |
 | 周日 | 下周计划 | 休息 | 家庭时间 | 🟢 低 | ⏳ 待开始 |
 ​
 ## 📊 本周进度
 ​
 ### 学习进度
 ​
 ① Markdown基础 ────────── 100%
 ② 表格制作 ──────────── 100%
 ③ 图标使用 ───────────── 50%
 ④ 特殊元素 ───────────── 0%
 ​
 ### 工作进度
 ​
 - ✅ 已完成：2/7 (28.6%)
 - 🔄 进行中：1/7 (14.3%)
 - ⏳ 待开始：4/7 (57.1%)
 ​
 ## 💰 时间分配
 ​
 | 类别 | 预计时间 |
 |:-----|:---------|
 | 📚 学习 | ⏰ 10小时 |
 | 💼 工作 | ⏰ 40小时 |
 | 🏠 生活 | ⏰ 20小时 |
 | **总计** | **⏰ 70小时** |
 ​
 ## 🎯 本周目标
 ​
 - [x] 学会Markdown基础
 - [x] 学会表格制作
 - [ ] 学会图标使用
 - [ ] 学会特殊元素
 - [ ] 完成工作汇报
 ​
 ---
 ​
 加油！继续努力！💪

特点：优先级和状态一眼就能看到，时间分配清楚，进度一目了然。做管理、做计划，这个版本很好用。

案例三：读书笔记模板

记读书笔记，这么做结构特别清楚：

 # 《深入理解计算机系统》读书笔记 📖
 ​
 ## 📚 书籍信息
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 📖 书名 | 深入理解计算机系统 |
 | 👤 作者 | Randal E. Bryant / David R. O'Hallaron |
 | ⭐ 评分 | ⭐⭐⭐⭐⭐ (5/5) |
 | 📅 开始时间 | 2026年3月1日 |
 | 📆 当前进度 | 第3章 / 共12章 (25%) |
 | 📝 阅读状态 | 🔄 阅读中 |
 ​
 ## 🏷️ 知识标签
 ​
 - 🏗️ 计算机体系结构
 - 🔧 系统编程
 - 💻 汇编语言
 - ⚙️ 系统优化
 - 💾 内存管理
 ​
 ## 🎯 阅读目标
 ​
 - [x] 第一章：计算机系统漫游
 - [x] 第二章：信息的表示和处理
 - [ ] 第三章：程序的机器级表示
 - [ ] 第四章：处理器体系结构
 - [ ] 第五章：优化程序性能
 - [ ] 第六章：存储器层次结构
 - [ ] 第七章：链接
 - [ ] 第八章：异常控制流
 - [ ] 第九章：虚拟存储器
 - [ ] 第十章：系统级I/O
 - [ ] 第十一章：网络编程
 - [ ] 第十二章：并发编程
 ​
 ## 📝 章节笔记
 ​
 ### 第一章：计算机系统漫游 ✅
 ​
 **核心内容**：
 - 计算机系统的基本组成
 - 硬件和软件的关系
 ​
 **💡 重要概念**：
 - 程序员需要理解整个系统
 - 硬件和软件协同工作
 ​
 **❓ 疑问**：
 - 如何优化程序性能？
 - 系统调优的最佳实践？
 ​
 ### 第二章：信息的表示和处理 ✅
 ​
 **核心内容**：
 - 数据的表示方法
 - 整数和浮点数运算
 ​
 **💡 重要概念**：
 - 二进制表示
 - 补码运算
 - IEEE 浮点数标准
 ​
 **⚠️ 注意**：
 - 有符号数和无符号数的区别
 - 溢出的处理
 ​
 ### 第三章：程序的机器级表示 🔄
 ​
 **核心内容**：
 - 汇编语言基础
 - 机器码与汇编
 ​
 **💡 重要概念**：
 - 寄存器使用
 - 指令格式
 - 过程调用机制
 ​
 **📌 重点**：
 - 理解函数调用的过程
 - 掌握栈的使用
 ​
 ## 📈 阅读进度
 ​

第一章：████████████████████ 100% 第二章：████████████████████ 100% 第三章：████░░░░░░░░░░░░░░ 25% 第四章：░░░░░░░░░░░░░░░░░░░ 0%

 ​
 ## 💡 行动计划
 ​
 阅读完这本书后：
 - [ ] 复习 CSAPP 课程
 - [ ] 完成配套实验
 - [ ] 实践系统编程
 - [ ] 分享学习心得
 ​
 ---
 ​
 继续阅读！💪

特点：

  • 书籍信息、进度一目了然
  • 用标签分类，后面找起来方便
  • 每章都分开记，结构清晰
  • 最后有行动计划，读完不是真读完，能落实

案例四：旅游攻略

出去旅游做攻略，这么写，清晰又好用：

 # 西安三日游攻略 ✈️
 ​
 ## 📋 行程概览
 ​
 | 日期 | 景点 | 活动 | 住宿 | 预算 |
 |:-----|:-----|:-----|:-----|:-----|
 | Day 1 | 兵马俑、华清宫 | 参观、拍照 | 酒店 A | 800元 |
 | Day 2 | 大雁塔、大唐不夜城 | 观光、购物 | 酒店 A | 600元 |
 | Day 3 | 明城墙、钟楼 | 逛古街、美食 | - | 400元 |
 ​
 ## 🏛️ 景点详细
 ​
 ### Day 1：兵马俑、华清宫
 ​
 #### 兵马俑 🏆 ⭐⭐⭐⭐⭐
 - **推荐指数**：⭐⭐⭐⭐⭐ (5/5)
 - **游玩时间**：3-4 小时
 - **门票**：120 元
 - **我的建议**：
   - 早上早点去，避开人流
   - 雇个讲解员，能听懂历史
   - 带好水和零食，里面挺大的
 ​
 #### 华清宫 ⭐⭐⭐⭐☆
 - **推荐指数**：⭐⭐⭐⭐☆ (4.5/5)
 - **游玩时间**：2-3 小时
 - **门票**：120 元
 - **我的建议**：
   - 傍晚去，还能看《长恨歌》演出
   - 演出真的值得一看，提前订票
 ​
 ### Day 2：大雁塔、大唐不夜城
 ​
 #### 大雁塔 ⭐⭐⭐⭐☆
 - **推荐指数**：⭐⭐⭐⭐☆ (4.5/5)
 - **游玩时间**：1-2 小时
 - **门票**：50 元
 - **我的建议**：
   - 登塔能俯瞰西安城
   - 旁边就是博物馆，可以一起逛
 ​
 #### 大唐不夜城 🌟 ⭐⭐⭐⭐⭐
 - **推荐指数**：⭐⭐⭐⭐⭐ (5/5)
 - **游玩时间**：2-3 小时
 - **门票**：免费
 - **我的建议**：
   - 一定要晚上去，夜景真的太美了
   - 适合拍照打卡，很多古风装饰
   - 街边很多小吃，可以边走边吃
 ​
 ## 🍜 美食推荐
 ​
 ### 必吃美食
 ​
 | 美食 | 推荐度 | 大概位置 | 价格 | 我的建议 |
 |:-----|:-------|:-----|:-----|:-----|
 | 肉夹馍 | ⭐⭐⭐⭐⭐ | 回民街 | 15 元 | 刚出炉的最好吃 |
 | 羊肉泡馍 | ⭐⭐⭐⭐⭐ | 回民街 | 30 元 | 自己掰馍才有仪式感 |
 | 凉皮 | ⭐⭐⭐⭐☆ | 到处都有 | 10 元 | 加辣更过瘾 |
 | 胡辣汤 | ⭐⭐⭐⭐☆ | 早餐摊 | 15 元 | 早餐吃特别舒服 |
 ​
 ### 📍 推荐餐厅
 ​
 #### 回民街 🌶️ ⭐⭐⭐⭐⭐
 - **推荐度**：⭐⭐⭐⭐⭐ (5/5)
 - **特色**：各种地道小吃都有
 - **建议**：晚上去气氛最好，多尝几种
 ​
 ---
 ​
 ## 💰 预算总结
 ​
 | 项目 | 预算 |
 |:-----|:-----|
 | 🚗 交通 | 500 元 |
 | 🎫 门票 | 450 元 |
 | 🏨 住宿 | 800 元 |
 | 🍜 美食 | 500 元 |
 | 🛍️ 购物 | 300 元 |
 | **总计** | **2550 元** |
 ​
 ## 💡 出行建议
 ​
 ### 🎒 行李准备
 - 身份证
 - 充电宝
 - 舒服的鞋子（要走很多路）
 - 防晒用品
 - 雨伞
 ​
 ### ⚠️ 注意事项
 - 热门景点提前订票，别跑空
 - 现在是什么温度穿什么衣服
 - 人多看好东西，注意安全
 - 尊重当地文化习俗
 ​
 ---
 ​
 祝你旅途愉快！🎉

这样做攻略，朋友拿去直接用，特别清楚。

案例五：项目进度表

做项目管理，这样写，团队每个人都能看懂：

 # OpenClaw 平台开发项目进度 🚀
 ​
 ## 📋 项目信息
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 📝 项目名称 | OpenClaw 平台开发 |
 | 🎯 项目目标 | 构建 AI 代理开发平台 |
 | 👥 负责团队 | 研发部 |
 | 📅 开始时间 | 2026 年 1 月 1 日 |
 | 📆 预计完成 | 2026 年 6 月 30 日 |
 | 📊 当前进度 | 45% |
 | 🔄 项目状态 | 🔄 进行中 |
 ​
 ## 🎯 项目阶段
 ​
 ### 第一阶段：需求分析 ✅ (100%)
 ​
 | 任务 | 负责人 | 完成度 | 状态 | 完成时间 |
 |:-----|:-------|:-------|:-------|:--------|
 | 用户调研 | 张三 | 100% | ✅ 已完成 | 2026-01-15 |
 | 需求文档 | 李四 | 100% | ✅ 已完成 | 2026-01-20 |
 | 技术选型 | 王五 | 100% | ✅ 已完成 | 2026-01-25 |
 ​
 ### 第二阶段：系统设计 ✅ (100%)
 ​
 | 任务 | 负责人 | 完成度 | 状态 | 完成时间 |
 |:-----|:-------|:-------|:-------|:--------|
 | 架构设计 | 赵六 | 100% | ✅ 已完成 | 2026-02-05 |
 | 数据库设计 | 张三 | 100% | ✅ 已完成 | 2026-02-10 |
 | API 设计 | 李四 | 100% | ✅ 已完成 | 2026-02-15 |
 ​
 ### 第三阶段：核心开发 🔄 (60%)
 ​
 | 任务 | 负责人 | 完成度 | 状态 | 预计完成 |
 |:-----|:-------|:-------|:-------|:--------|
 | 用户模块 | 王五 | 100% | ✅ 已完成 | 2026-02-28 |
 | 代理模块 | 赵六 | 90% | 🔄 进行中 | 2026-03-10 |
 | 技能模块 | 张三 | 70% | 🔄 进行中 | 2026-03-15 |
 | 集成测试 | 李四 | 0% | ⏳ 待开始 | 2026-03-20 |
 ​
 ## 📊 整体进度
 ​

第一阶段：需求分析 ████████████████████ 100% 第二阶段：系统设计 ████████████████████ 100% 第三阶段：核心开发 ████████░░░░░░░░░░ 60% 第四阶段：前端开发 ████░░░░░░░░░░░░░░ 40% 第五阶段：测试上线 ░░░░░░░░░░░░░░░░░░░ 0%


---

项目顺利推进中！💪

特点：谁负责什么，做到哪了，什么时候完成，一目了然。开站会不用多说，大家看文档就懂了。

4.7 工具兼容性指南：哪些功能哪些工具支持

前面我们学了一堆 Markdown 进阶功能，你肯定会问：我用的 XX 工具支持这些功能吗？

这一节我给你整理好了一个完整的对照表，不同工具支持哪些功能，一眼就能看明白。你写之前先看看，就不会白忙活半天写好了显示不出来。

符号说明

  • ✅ 完全支持：放心用，没问题
  • ⚠️ 部分支持：有功能限制，看说明
  • ❌ 不支持：别用，用了显示不出来
  • 🔧 需要插件：装了插件才能用

网页发布平台

掘金

掘金是国内最大的技术社区，写技术文章特别好用。

功能支持度说明
基础语法✅全都支持
表格✅完全支持
代码块✅ 支持语法高亮没问题
Emoji✅完全支持
链接✅完全支持
图片✅直接上传，自动转网络地址
HTML⚠️有限制，不是都支持
数学公式❌不支持
Mermaid 图表❌不支持

适合做什么：技术文章、学习笔记、经验分享 ✅

推荐指数：⭐⭐⭐⭐⭐

知乎

知乎国内最大的问答社区，写文章回答问题都能用。

功能支持度说明
基础语法✅全都支持
表格✅完全支持
代码块✅ 支持语法高亮没问题
Emoji✅完全支持
链接✅完全支持
图片✅直接上传
HTML❌基本不支持
数学公式❌不支持
Mermaid 图表❌不支持

适合做什么：回答问题、写文章、分享知识 ✅

推荐指数：⭐⭐⭐⭐

企业知识库 / 团队协作

语雀

语雀是阿里出的知识库工具，对 Markdown 支持得特别好，我个人很推荐。

功能支持度说明
基础语法✅全都支持
表格✅复杂表格也支持
代码块✅ 支持语法高亮、行号没问题
Emoji✅完全支持
链接✅ 支持文档内锚点没问题
图片✅直接上传
HTML✅支持改颜色、居中这些
数学公式✅完整支持 LaTeX
Mermaid 图表✅完整支持
折叠内容✅原生支持，语法简单

适合做什么：企业文档、个人知识库、团队协作、技术文档 ✅

推荐指数：⭐⭐⭐⭐⭐⭐（满分）

飞书文档

飞书是字节出的协作办公平台，Markdown 支持得也不错。

功能支持度说明
基础语法✅全都支持
表格✅完全支持
代码块✅ 支持语法高亮没问题
Emoji✅完全支持
链接✅完全支持
图片✅直接上传
HTML⚠️部分支持
数学公式⚠️部分支持
Mermaid 图表⚠️部分支持

适合做什么：团队协作、项目文档、会议记录 ✅

推荐指数：⭐⭐⭐⭐⭐

本地编辑器

Typora

我个人最推荐的 Markdown 编辑器，没有之一，功能最全，体验最好。

功能支持度说明
基础语法✅完美支持
表格✅ 还能可视化编辑体验超好
代码块✅ 完美语法高亮没问题
Emoji✅ 还能自动补全太方便了
链接✅完美支持
图片✅ 拖拽就能插入体验超好
HTML✅完美支持
数学公式✅完美支持 LaTeX
Mermaid 图表✅完美支持，实时渲染
图片大小控制✅支持 =600x400 语法
所见即所得✅一直就是

价格：付费软件，学生免费，普通人 100 块钱左右永久授权，值。

适合做什么：本地写作、记笔记、编辑文档，什么都适合 ✅

推荐指数：⭐⭐⭐⭐⭐⭐（满分）

VS Code

开发者基本都装了，装个插件就能用 Markdown。

功能支持度说明
基础语法✅完全支持
表格✅完全支持
代码块✅完全支持
Emoji✅完全支持
链接✅完全支持
图片✅完全支持
HTML✅完全支持
数学公式🔧需要装插件
Mermaid 图表🔧需要装插件
实时预览🔧需要装插件

适合做什么：开发者写技术文档、项目 README ✅

推荐指数：⭐⭐⭐⭐（开发者推荐）

Obsidian

适合做个人知识管理，基于本地 Markdown 文件，双链笔记特别好用。

功能支持度说明
基础语法✅完全支持
表格✅完全支持
代码块✅完全支持
Emoji✅完全支持
链接✅ 支持文档内链双链是核心功能
图片✅完全支持
HTML✅完全支持
数学公式🔧需要装插件
Mermaid 图表🔧需要装插件
折叠内容🔧需要装插件

适合做什么：个人知识库、管理大量笔记 ✅

推荐指数：⭐⭐⭐⭐

怎么选工具？我给你总结好了

编辑器怎么选

你的场景选什么工具为什么
平时就写文章记笔记Typora功能最强，体验最好，一步到位
你是开发者VS Code本来就用它写代码，装个插件就能用
你需要管理很多笔记Obsidian双链笔记真的好用，适合知识管理
团队一起协作语雀 / 飞书协作功能强大，Markdown 支持也好

发布平台怎么选

你的场景选什么平台为什么
发技术文章掘金技术用户多，支持好
发问答文章知乎用户多，流量大
自己存笔记本地 + 云端备份自己说了算

不同场景怎么选功能

我给你三个策略，根据你的情况选：

保守策略（推荐给新手）

放心用这些：

  • ✅ 所有基础语法（标题、段落、加粗、斜体、列表、代码块）
  • ✅ 表格
  • ✅ Emoji
  • ✅ 链接
  • ✅ 图片

别碰这些：

  • ❌ HTML 美化
  • ❌ 数学公式
  • ❌ Mermaid 图表

为什么：所有工具都支持这些基础功能，肯定显示没问题，不会踩坑。

标准策略（推荐给大多数人）

放心用这些：

  • ✅ 所有基础功能
  • ✅ 表格、代码块（带高亮）
  • ✅ Emoji
  • ✅ 链接（包括锚点）
  • ✅ 图片
  • ✅ 简单 HTML（改颜色、居中）

谨慎用这些：

  • ⚠️ 复杂 HTML 少用
  • ⚠️ 数学公式只有确实需要再用
  • ⚠️ Mermaid 图表只有确实需要再用

为什么：功能够用了，兼容性也还好，不会出什么大问题。

进阶策略（专业文档用）

放心用所有功能，但是：

  • 一定要先确认你的工具支持不支持
  • 一定要打开预览看看显示对不对
  • 如果要跨平台发布，记得给不支持的工具做个简化版本

最后几个提醒

跨平台发布要注意

如果你写一篇文章要发到好几个平台，一定要：

  1. 尽量只用基础功能，大家都支持
  2. 每个平台都打开预览一下，看看显示对不对
  3. 重要功能显示不对，立刻改

本地写好了再传到云端

如果你本地用 Typora 写，写好了再传到语雀/飞书，一般没问题，大部分功能都兼容。如果真有不兼容的，到云端再微调一下。

记得备份

不管用什么工具，自己本地存一份 Markdown 源文件总是没错的。就算平台倒闭了，你文件还在。

4.8 常见问题解答，遇到问题自己就能解决

学了这么多，你肯定会遇到一些小问题。这一节我把新手最常遇到的问题收集起来，一个个给你说怎么解决。看完这一节，遇到问题你自己就能搞定。

问题一：表格列宽不对齐，怎么办？

问题就是这样：

你做了一个表格，显示出来列歪歪扭扭，有的特别宽有的特别窄，看着不舒服。

为什么会这样？

标准 Markdown 不能直接定死列宽，列宽是工具根据内容自动算出来的。内容长短不一样，列宽自然不一样。

怎么解决？我给你几个方案：

方案一：调整表头文字，让它和内容长度匹配

比如你表头写”城市”，内容都是”北京””上海”，长度匹配，看着就整齐了：

姓名年龄居住城市
张三25北京
李四30上海

方案二：如果你的工具支持 HTML，直接定宽度

比如语雀就支持：

 <table>
   <tr>
     <th width="20%">姓名</th>
     <th width="20%">年龄</th>
     <th width="60%">居住城市</th>
   </tr>
   <tr>
     <td>张三</td>
     <td>25</td>
     <td>北京</td>
   </tr>
 </table>

这样每列宽度直接定死，肯定整齐。

给新手的建议：

  • 一列就放一类内容，别放太长
  • 一表格别超过五列，列多了肯定挤
  • 用 Typora 或者语雀，它们对表格支持最好，好看

问题二：图片显示不出来，怎么办？

两种情况：

  • 本地图片打开不显示
  • 网络图片打开裂图

为什么会这样？

  • 路径写错了（最常见）
  • 图片被删掉了，链接失效了
  • 格式不对，工具不支持

怎么解决？

如果是本地图片：

检查文件路径对不对，比如：

 你的文档在：book/chapter.md
 你的图片在：book/images/screenshot.png
 正确路径就是：images/screenshot.png
 错的路径：/images/screenshot.png（多了个斜杠）

你就打开文件夹看看，图片到底在哪，路径对着了，自然就能显示。

如果是发网页（掘金/知乎）：

你不能直接放本地路径，得先把图片上传到网站，网站会给你一个网络地址，你用那个网络地址就能显示。

如果是网络图片：

你把链接复制到浏览器地址栏，打开看看能显示吗？打不开就是链接错了或者图片删了，换个链接就行。

最佳实践：

  • 截图用 PNG，照片用 JPG，这两个格式所有工具都支持
  • 图片别太大，压缩一下，加载快
  • 发网页一定要用网络链接，本地路径显示不出来
  • 重要图片自己存一份，防止链接失效

问题三：链接点不开，怎么办？

为什么会这样？

最常见就是地址写错了，少了 https://，或者拼错域名了。锚点跳转（页内跳转）就是锚点名字不对。

怎么解决？

外部链接：

 [掘金](https://juejin.cn) ✅ 对
 [掘金](juejin.cn) ❌ 错，少了协议
 [掘金](https://juejin/cn) ❌ 错，域名拼错了

写完了，你自己点一下试试，能打开就是对的。点不开就改。

页内锚点：

  • Typora/语雀：## 第一章 {: #chapter1} 然后 [第一章](#chapter1)，这样就对了
  • 掘金/知乎：标题自动生成锚点，## 第一章 对应 #第一章，直接用就行

反正写完点一下，能跳过去就是对的。

问题四：整篇文章排版乱了，怎么办？

为什么会这样？

90% 就是忘记空行。Markdown 要空行分隔段落、分隔标题，你都挤在一起，它当然认错。

错的写法：

 # 第一章
 段落一
 段落二
 ## 第二章

对的写法：

 # 第一章
 ​
 段落一
 ​
 段落二
 ​
 ## 第二章
 ​
 段落三

记住：标题前后空行，段落之间空行，列表前后空行，这样就不会乱。

如果还是乱，检查一下换行符，不同系统换行符不一样，你在编辑器里统一换成 LF 就行，VS Code 和 Typora 都能换。

问题五：表情显示成方块，怎么办？

就是你的系统字体不支持 Emoji，或者文件编码不对。

解决步骤：

第一步：检查文件编码，一定要用 UTF-8

现在所有编辑器默认都是 UTF-8，一般没问题，真错了改过来就行。

第二步：更新系统字体

  • Windows：确保你装了 Segoe UI Emoji 字体，一般更新系统就有了
  • Mac：系统自带，不用装
  • Linux：装 fonts-noto-color-emoji 这个包就行

如果还是不行：

那就用文本符号代替，用 * ! X OK 一样能用，不一定非要 Emoji。

问题六：高阶功能显示不出来，怎么办？

比如 HTML、数学公式、Mermaid 图表，显示不出来。

为什么？

不是所有工具都支持所有功能，你得先确认你的工具支持不支持，这一章前面有兼容性表格，你可以去对照一下。

如果工具支持还是显示不对，那就是你语法写错了，比如 HTML 少了个括号，数学公式少了个 $，仔细检查一下。

如果真不支持怎么办？

用基础功能降级：

 <!-- HTML 改颜色（高级）-->
 <span style="color: red;">重要</span>
 ​
 <!-- 改成加粗（基础）-->
 **重要**

能用就行，不一定非要用高级功能。

几个通用好习惯，能帮你避免很多问题

一、用 Git 做版本控制

 git init
 git add .
 git commit -m "第一次提交"

好处就是，你改坏了，随时能退回去，不怕误删。

二、定期备份

重要文档，本地存一份，云端存一份，不怕丢。

三、用模板

常用的文档，做好模板，用的时候直接填内容，格式不会错，还快。

四、打开拼写检查

大部分编辑器都支持，帮你找错别字，不用自己一个个查。

五、记住常用快捷键

功能快捷键（Typora/VS Code 通用）
加粗Ctrl + B
斜体Ctrl + I
链接Ctrl + K
代码块Ctrl + Shift + K

用快捷键比你用鼠标点快多了。

4.9 实战练习：检验一下学习成果

这是第四章最后一节，我们来做几个实战练习，检验一下你学的怎么样。你跟着做一遍，第四章内容就真正掌握了。

练习一：做一张简单的周计划表

练习目标

用基础语法做一张周计划表，什么高阶功能都不用。

要求

  • 用表格放内容
  • 要有：日期、任务、预计时间、完成状态
  • 只用基础语法，先别用图标

完成了可以参考这个：

 # 本周计划
 ​
 | 日期 | 任务 | 时间 | 状态 |
 |:-----|:-----|:-----|:-----|
 | 周一 | 学 Markdown 基础 | 2小时 | 完成 |
 | 周二 | 学做表格 | 2小时 | 完成 |
 | 周三 | 学学怎么用图标 | 1小时 | 进行中 |
 | 周四 | 学链接和图片 | 1小时 | 未开始 |
 | 周五 | 总结复习 | 1小时 | 未开始 |

自己检查一下：

  • 表格语法对不对
  • 每列数量一致吗
  • 内容都齐了吗
  • 打开能正常显示吗

练习二：给周计划表加上图标美化

练习目标

在练习一的基础上，加上图标，让它更好看。

要求

  • 加上 Emoji 图标
  • 用 ✅🔄⏳ 表示状态
  • 用 🔴🟡🟢 表示优先级

完成了可以参考这个：

 # 本周计划 📅
 ​
 | 日期 | 任务 | 时间 | 优先级 | 状态 |
 |:-----|:-----|:-----|:-------|:-------|
 | 周一 | 学 Markdown 基础 | 2小时 | 🔴 高 | ✅ 完成 |
 | 周二 | 学做表格 | 2小时 | 🔴 高 | ✅ 完成 |
 | 周三 | 学学怎么用图标 | 1小时 | 🟡 中 | 🔄 进行中 |
 | 周四 | 学链接和图片 | 1小时 | 🟡 中 | ⏳ 未开始 |
 | 周五 | 总结复习 | 1小时 | 🟢 低 | ⏳ 未开始 |
 ​
 ## 本周重点
 ​
 - 搞定基础语法
 - 学会做表格
 - 会用图标美化
 ​
 加油！💪

自己检查一下：

  • 图标能正常显示吗
  • 状态和优先级看一眼能明白吗
  • 整体看起来是不是好看多了

练习三：做一份漂亮的个人简历

练习目标

用表格和图标做一份漂亮的个人简历。

要求

  • 基本信息放表格里
  • 用图标分类
  • 要有：基本信息、教育背景、工作经验、技能清单

你可以参考这个：

 # 个人简历 📄
 ​
 ## 👤 基本信息
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 📛 姓名 | 张三 |
 | 👤 性别 | 男 |
 | 🎂 年龄 | 25 |
 | 📞 电话 | 138-1234-5678 |
 | 📧 邮箱 | zhangsan@email.com |
 | 📍 地址 | 北京市朝阳区 |
 ​
 ## 🎓 教育背景
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 🏫 学校 | 北京大学 |
 | 📚 专业 | 计算机科学与技术 |
 | 📅 时间 | 2016-2020 |
 | 🎓 学历 | 本科 |
 ​
 ## 💼 工作经验
 ​
 ### 软件工程师 ⭐⭐⭐⭐⭐
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 🏢 公司 | 某互联网公司 |
 | 📅 时间 | 2020-2023 |
 | 📋 主要职责 | 后端开发 |
 ​
 ## 🔧 技能
 ​
 | 类别 | 技能 |
 |:-----|:-----|
 | 💻 编程语言 | Python、Java、JavaScript |
 | 🧩 框架 | Django、Spring Boot |
 | 🗄️ 数据库 | MySQL、MongoDB |
 ​
 ---
 ​
 *感谢您的阅读* 🙏

自己检查一下：

  • 信息完整吗
  • 表格格式对吗
  • 图标用得合适吗
  • 整体看起来专业吗

练习四：做一份旅游攻略

练习目标

做一份三天旅游攻略，会用评分，会写建议。

要求

  • 行程放表格里
  • 景点用星级评分
  • 每个景点给出行建议
  • 加上美食推荐

你可以参考这个：

 # 西安三日游攻略 ✈️
 ​
 ## 📋 行程概览
 ​
 | 日期 | 景点 | 评分 | 门票 |
 |:-----|:-----|:-----|:-----|
 | Day 1 | 兵马俑 | ⭐⭐⭐⭐⭐ | 120元 |
 | Day 2 | 大雁塔 | ⭐⭐⭐⭐☆ | 50元 |
 | Day 3 | 明城墙 | ⭐⭐⭐⭐☆ | 54元 |
 ​
 ## 🏛️ 景点细说
 ​
 ### 兵马俑 ⭐⭐⭐⭐⭐
 ​
 **我的建议**：
 - 一定要早点去，避开人流
 - 雇个讲解员，能听懂历史
 - 里面大，带够水和吃的
 ​
 ### 大雁塔 ⭐⭐⭐⭐☆
 ​
 **我的建议**：
 - 登塔能俯瞰整个西安城
 - 旁边就是博物馆，可以一起逛
 - 晚上去大唐不夜城，夜景真的漂亮
 ​
 ## 🍜 美食推荐
 ​
 | 美食 | 评分 | 价格 |
 |:-----|:-----|:-----|
 | 肉夹馍 | ⭐⭐⭐⭐⭐ | 15元 |
 | 羊肉泡馍 | ⭐⭐⭐⭐⭐ | 30元 |
 | 凉皮 | ⭐⭐⭐⭐☆ | 10元 |
 ​
 ## 💰 总预算
 ​
 | 项目 | 金额 |
 |:-----|:-----|
 | 🎫 门票 | 224元 |
 | 🍜 美食 | 300元 |
 | 🏨 住宿 | 600元 |
 | **总计** | **1124元** |
 ​
 ---
 ​
 祝你玩得开心！🎉

练习五：做一张项目进度表

练习目标

做项目进度跟踪，会用状态图标，会做进度条。

要求

  • 任务放表格里
  • 用状态图标表示进度
  • 做一个整体进度条

你可以参考这个：

 # 项目进度表 🚀
 ​
 ## 📊 项目基本信息
 ​
 | 项目 | 内容 |
 |:-----|:-----|
 | 📝 项目名称 | Markdown 学习 |
 | 🎯 项目目标 | 掌握所有 Markdown 语法 |
 | 📊 当前进度 | 45% |
 | 🔄 项目状态 | 🔄 进行中 |
 ​
 ## 🎯 任务列表
 ​
 | 阶段 | 任务 | 完成度 | 状态 |
 |:-----|:-----|:-------|:-------|
 | 基础 | 基础语法 | 100% | ✅ 完成 |
 | 基础 | 表格制作 | 100% | ✅ 完成 |
 | 进阶 | 图标使用 | 50% | 🔄 进行中 |
 | 进阶 | 链接图片 | 0% | ⏳ 未开始 |
 ​
 ## 📈 整体进度
 ​

基础语法：████████████████████ 100% 表格制作：████████████████████ 100% 图标使用：████████░░░░░░░░░░ 50% 链接图片：░░░░░░░░░░░░░░░░░░░░ 0%

 ​
 ---
 ​
 项目继续推进中！💪

练习六：做一份个人学习计划

练习目标

做一份学习计划，会用优先级，会跟踪进度。

要求

  • 用表格安排学习时间
  • 用优先级区分任务
  • 用复选框跟踪完成情况

你可以参考这个：

 # Markdown 学习计划 📚
 ​
 ## 🎯 学习目标
 ​
 学会 Markdown，能独立写出漂亮的专业文档。
 ​
 ## 📅 学习安排
 ​
 | 周期 | 学习内容 | 优先级 | 状态 | 预计时间 |
 |:-----|:---------|:-------|:-------|:---------|
 | 第一周 | 基础语法 | 🔴 高 | ✅ 完成 | 10小时 |
 | 第二周 | 表格制作 | 🔴 高 | ✅ 完成 | 8小时 |
 | 第三周 | 图标使用 | 🟡 中 | 🔄 进行中 | 6小时 |
 | 第四周 | 链接图片 | 🟡 中 | ⏳ 未开始 | 8小时 |
 | 第五周 | 高阶技巧 | 🟢 低 | ⏳ 未开始 | 6小时 |
 | 第六周 | 实战练习 | 🔴 高 | ⏳ 未开始 | 10小时 |
 ​
 ## 📊 当前进度
 ​

第一周：████████████████████ 100% 第二周：████████████████████ 100% 第三周：█████████░░░░░░░░░ 75% 第四周：░░░░░░░░░░░░░░░░░░░░ 0%

 ​
 ---
 ​
 加油，马上就完成第四章了！💪

恭喜你完成所有练习！

做完这六个练习，你应该掌握了：

✅ 会做表格，从简单到美化 ✅ 会用图标，让文章生动起来 ✅ 会做简历、攻略、进度表、计划，都是日常最常用的 ✅ 知道怎么结合各种技巧做出漂亮文档

第四章我们就学完了，我给你总结一下：

章节内容掌握了吗
4.1为什么要做好排版⭐⭐⭐⭐⭐
4.2怎么制作表格⭐⭐⭐⭐⭐
4.3怎么用图标⭐⭐⭐⭐⭐
4.4链接、图片和代码块⭐⭐⭐⭐☆
4.5高阶排版技巧⭐⭐⭐⭐☆
4.6实战案例参考⭐⭐⭐⭐⭐
4.7工具兼容性⭐⭐⭐⭐☆
4.8常见问题解决⭐⭐⭐⭐☆
4.9实战练习⭐⭐⭐⭐⭐

核心就是：

  • 表格让数据清清楚楚
  • 图标让文章生动起来
  • 先确认你的工具支持什么功能，别瞎用
  • 遇到问题，常见问题那章就能解决

现在你已经能做出漂亮的专业文档了。下一章我们学习结构化写作，让长文章也能清清楚楚，读者一眼就能找到他想看的内容。