> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.
# 第二天|进阶语法
> 掌握表格、链接、图片、引用和任务列表
**今日目标**：学会 Markdown 的进阶语法——表格、链接、图片、引用块和任务列表。这些语法能让你的文档更专业、更美观。
## 学习内容 (30 mins)
**表格的作用**
表格用于展示结构化数据，比如项目进度、数据对比等。
**基本语法**：
```markdown theme={null}
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
```
**对齐方式**：
* **左对齐**：`|:-----|`（默认）
* **居中**：`|:----:|`
* **右对齐**：`|-----:|`
**示例**：
```markdown theme={null}
| 姓名 | 年龄 | 城市 |
|:-----|:----:|-----:|
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |
```
**效果**：
| 姓名 | 年龄 | 城市 |
| :- | :-: | -: |
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |
**注意事项**：
* 第一行是表头
* 第二行是分隔线（必须）
* 列之间用 `|` 分隔
* 对齐符号放在分隔线中
**两种链接方式**
* **行内链接**：`[链接文字](URL)`
* **引用链接**：`[链接文字][引用名]`，然后在文档底部定义 `[引用名]: URL`
**行内链接示例**：
```markdown theme={null}
访问 [GitHub](https://github.com)
查看 [Markdown 指南](https://www.markdownguide.org/)
```
**引用链接示例**：
```markdown theme={null}
访问 [GitHub][1] 和 [Markdown 指南][2]
[1]: https://github.com
[2]: https://www.markdownguide.org/
```
**自动链接**：
直接写 URL，会自动变成链接：
```markdown theme={null}
https://github.com
```
**图片语法**
图片语法和链接类似，前面加个 `!`：
```markdown theme={null}
```
**示例**：
```markdown theme={null}
```
**引用方式**：
```markdown theme={null}
![图片描述][logo]
[logo]: https://example.com/logo.png
```
**注意事项**：
* 图片描述（alt text）用于图片加载失败时显示
* 本地图片需要上传到图床或使用相对路径
* GitHub 支持直接拖拽图片到编辑器
**引用块的作用**
用于引用他人的话、重要提示、注意事项等。
**语法**：
用 `>` 开头，可以嵌套。
```markdown theme={null}
> 这是一段引用文字。
> 可以写多行。
> 也可以嵌套引用：
>> 这是嵌套的引用。
```
**效果**：
> 这是一段引用文字。
> 可以写多行。
> 也可以嵌套引用：
>
> > 这是嵌套的引用。
**常见用途**：
* 引用他人观点
* 重要提示
* 注意事项
* 代码说明
**任务列表**
用于创建待办事项列表，可以勾选。
**语法**：
```markdown theme={null}
- [ ] 未完成的任务
- [x] 已完成的任务
```
**效果**：
* [ ] 未完成的任务
* [x] 已完成的任务
**注意事项**：
* `[ ]` 表示未完成（中间有空格）
* `[x]` 表示已完成（x 可以大写或小写）
* 可以和无序列表、有序列表组合
***
## 实践任务 (60 mins)
用表格制作一个项目进度表。
**要求**：
* 包含：任务名称、负责人、状态、完成度
* 状态列居中显示
* 完成度列右对齐显示
**源代码**：
```markdown 示例 theme={null}
| 任务名称 | 负责人 | 状态 | 完成度 |
|:--------|:------:|:----:|------:|
| 需求分析 | 张三 | 已完成 | 100% |
| UI 设计 | 李四 | 进行中 | 60% |
| 开发 | 王五 | 未开始 | 0% |
```
**渲染效果预览**：
在 Mintlify 中，下面的表格会被自动渲染：
| 任务名称 | 负责人 | 状态 | 完成度 |
| :---- | :-: | :-: | ---: |
| 需求分析 | 张三 | 已完成 | 100% |
| UI 设计 | 李四 | 进行中 | 60% |
| 开发 | 王五 | 未开始 | 0% |
**验证步骤**：
1. 在编辑器中输入表格
2. 检查对齐是否正确
3. 尝试添加更多行
在你的文档中添加链接和图片。
**链接任务**：
1. 添加 3 个外部链接（使用行内方式）
2. 添加 1 个引用链接
**图片任务**：
1. 如果使用 GitHub，可以直接拖拽图片
2. 或者使用在线图床（如 [imgur](https://imgur.com/)）
3. 添加图片并写上描述
**示例**：
```markdown theme={null}
## 相关资源
- 查看 [Markdown 官方指南](https://www.markdownguide.org/)
- 访问 [GitHub 文档](https://docs.github.com/)
```
创建一个包含引用和任务列表的文档。
**引用块示例**：
```markdown theme={null}
> **重要提示**：本项目需要在月底前完成。
>
> 如有问题，请联系项目经理。
```
**任务列表示例**：
```markdown theme={null}
## 本周任务
- [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 | 实战应用与最佳实践