Skip to main content
今日目标：学会 Markdown 的进阶语法——表格、链接、图片、引用块和任务列表。这些语法能让你的文档更专业、更美观。

​
学习内容 (30 mins)

表格的作用表格用于展示结构化数据，比如项目进度、数据对比等。基本语法：
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
对齐方式：
  • 左对齐：|:-----|（默认）
  • 居中：|:----:|
  • 右对齐：|-----:|
示例：
| 姓名 | 年龄 | 城市 |
|:-----|:----:|-----:|
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |
效果：
姓名年龄城市
张三25北京
李四30上海
注意事项：
  • 第一行是表头
  • 第二行是分隔线（必须）
  • 列之间用 | 分隔
  • 对齐符号放在分隔线中
两种链接方式
  • 行内链接：[链接文字](URL)
  • 引用链接：[链接文字][引用名]，然后在文档底部定义 [引用名]: URL
行内链接示例：
访问 [GitHub](https://github.com)
查看 [Markdown 指南](https://www.markdownguide.org/)
引用链接示例：
访问 [GitHub][1] 和 [Markdown 指南][2]

[1]: https://github.com
[2]: https://www.markdownguide.org/
自动链接：直接写 URL，会自动变成链接：
https://github.com
图片语法图片语法和链接类似，前面加个 !：
![图片描述](图片URL)
示例：
![公司 Logo](https://example.com/logo.png)
引用方式：
![图片描述][logo]

[logo]: https://example.com/logo.png
注意事项：
  • 图片描述（alt text）用于图片加载失败时显示
  • 本地图片需要上传到图床或使用相对路径
  • GitHub 支持直接拖拽图片到编辑器
引用块的作用用于引用他人的话、重要提示、注意事项等。语法：用 > 开头，可以嵌套。
> 这是一段引用文字。
> 可以写多行。

> 也可以嵌套引用：
>> 这是嵌套的引用。
效果：
这是一段引用文字。 可以写多行。
也可以嵌套引用：
这是嵌套的引用。
常见用途：
  • 引用他人观点
  • 重要提示
  • 注意事项
  • 代码说明
任务列表用于创建待办事项列表，可以勾选。语法：
- [ ] 未完成的任务
- [x] 已完成的任务
效果：
  • 未完成的任务
  • 已完成的任务
注意事项：
  • [ ] 表示未完成（中间有空格）
  • [x] 表示已完成（x 可以大写或小写）
  • 可以和无序列表、有序列表组合

​
实践任务 (60 mins)

1

任务 1: 制作项目进度表

用表格制作一个项目进度表。要求：
  • 包含：任务名称、负责人、状态、完成度
  • 状态列居中显示
  • 完成度列右对齐显示
源代码：
| 任务名称 | 负责人 | 状态 | 完成度 |
|:--------|:------:|:----:|------:|
| 需求分析 | 张三 | 已完成 | 100% |
| UI 设计 | 李四 | 进行中 | 60% |
| 开发 | 王五 | 未开始 | 0% |
渲染效果预览：
在 Mintlify 中，下面的表格会被自动渲染：
任务名称负责人状态完成度
需求分析张三已完成100%
UI 设计李四进行中60%
开发王五未开始0%
验证步骤：
  1. 在编辑器中输入表格
  2. 检查对齐是否正确
  3. 尝试添加更多行
2

任务 2: 添加链接和图片

在你的文档中添加链接和图片。链接任务：
  1. 添加 3 个外部链接（使用行内方式）
  2. 添加 1 个引用链接
图片任务：
  1. 如果使用 GitHub，可以直接拖拽图片
  2. 或者使用在线图床（如 imgur）
  3. 添加图片并写上描述
示例：
## 相关资源

- 查看 [Markdown 官方指南](https://www.markdownguide.org/)
- 访问 [GitHub 文档](https://docs.github.com/)

![项目截图](https://example.com/screenshot.png)
3

任务 3: 使用引用和任务列表

创建一个包含引用和任务列表的文档。引用块示例：
> **重要提示**：本项目需要在月底前完成。
> 
> 如有问题，请联系项目经理。
任务列表示例：
## 本周任务

- [x] 完成需求分析
- [x] 设计 UI 原型
- [ ] 开始开发
- [ ] 编写测试用例
- [ ] 部署上线
实践任务：创建一个”项目待办事项”文档，包含：
  • 项目说明（用引用块）
  • 任务列表（至少 5 项）

​
今日作业 (30 mins)

作业：编写项目进度报告

要求：
  1. 使用今天学的所有语法：
    • 至少 1 个表格（项目进度表）
    • 至少 3 个链接（相关资源）
    • 至少 1 张图片（项目截图或流程图）
    • 至少 1 个引用块（重要提示）
    • 至少 1 个任务列表（待办事项）
  2. 内容要求：
    • 项目概述
    • 进度表格
    • 相关链接
    • 待办事项
  3. 提交方式：
    • 保存为 day-02-项目进度报告.md
    • 在编辑器中预览效果
    • 截图或导出 PDF 提交
评分标准：
  • ✅ 语法正确（40 分）
  • ✅ 表格格式美观（30 分）
  • ✅ 内容完整（30 分）

​
今日产出物

  • day-02-项目进度报告.md - 包含表格、链接、图片的完整文档
  • 掌握 5 种进阶语法：表格、链接、图片、引用、任务列表

​
参考资源

查看参考示例

在 GitHub 查看完整示例

表格生成器

在线表格生成工具

​
常见问题

A: 建议保持一致。如果列数不一致，某些编辑器可能会显示异常。
A: 检查图片 URL 是否正确，或者使用相对路径。GitHub 支持直接拖拽图片。
A: 可以。和普通列表一样，通过缩进实现嵌套。

上一天: 基础语法

Day 1 | 基础语法入门

下一天: 实战应用

Day 3 | 实战应用与最佳实践