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

学习内容 (30 mins)

表格的作用表格用于展示结构化数据,比如项目进度、数据对比等。基本语法
对齐方式
  • 左对齐|:-----|(默认)
  • 居中|:----:|
  • 右对齐|-----:|
示例
效果注意事项
  • 第一行是表头
  • 第二行是分隔线(必须)
  • 列之间用 | 分隔
  • 对齐符号放在分隔线中
两种链接方式
  • 行内链接[链接文字](URL)
  • 引用链接[链接文字][引用名],然后在文档底部定义 [引用名]: URL
行内链接示例
引用链接示例
自动链接直接写 URL,会自动变成链接:
图片语法图片语法和链接类似,前面加个 !
示例
引用方式
注意事项
  • 图片描述(alt text)用于图片加载失败时显示
  • 本地图片需要上传到图床或使用相对路径
  • GitHub 支持直接拖拽图片到编辑器
引用块的作用用于引用他人的话、重要提示、注意事项等。语法> 开头,可以嵌套。
效果
这是一段引用文字。 可以写多行。
也可以嵌套引用:
这是嵌套的引用。
常见用途
  • 引用他人观点
  • 重要提示
  • 注意事项
  • 代码说明
任务列表用于创建待办事项列表,可以勾选。语法
效果
  • 未完成的任务
  • 已完成的任务
注意事项
  • [ ] 表示未完成(中间有空格)
  • [x] 表示已完成(x 可以大写或小写)
  • 可以和无序列表、有序列表组合

实践任务 (60 mins)

1

任务 1: 制作项目进度表

用表格制作一个项目进度表。要求
  • 包含:任务名称、负责人、状态、完成度
  • 状态列居中显示
  • 完成度列右对齐显示
源代码
渲染效果预览
在 Mintlify 中,下面的表格会被自动渲染:
验证步骤
  1. 在编辑器中输入表格
  2. 检查对齐是否正确
  3. 尝试添加更多行
2

任务 2: 添加链接和图片

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

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

创建一个包含引用和任务列表的文档。引用块示例
任务列表示例
实践任务创建一个”项目待办事项”文档,包含:
  • 项目说明(用引用块)
  • 任务列表(至少 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 | 实战应用与最佳实践