【Markdown-04】组织内容——呈现结构化数据

171 阅读16分钟

第 4 章:组织内容——呈现结构化数据

qrcode_for_gh_e1903e0c25a7_1280.jpg

在前面的章节中,我们学会了基本的文本格式化、链接和图片插入。现在,让我们学习如何使用更高级的语法来组织和呈现结构化数据。本章将重点介绍表格、任务列表和分割线,这些工具能让你的文档更加专业和易读。

4.1 表格:精通 GitHub Flavored Markdown (GFM) 表格语法

表格是展示结构化数据的最佳方式之一。虽然标准 Markdown 不支持表格,但 GitHub Flavored Markdown (GFM) 扩展了这一功能,现在几乎所有的 Markdown 解析器都支持表格语法。

基本表格语法

表格由管道符 | 分隔列,第二行使用连字符 - 定义表头:

| 姓名 | 年龄 | 职业 |
|------|------|------|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 产品经理 |

渲染效果:

姓名年龄职业
张三25工程师
李四30设计师
王五28产品经理

表格对齐方式

通过在分隔符行中添加冒号 : 来控制列的对齐方式:

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 文本 | 文本 | 文本 |
| 长一点的文本 | 长一点的文本 | 长一点的文本 |

渲染效果:

左对齐居中对齐右对齐
文本文本文本
长一点的文本长一点的文本长一点的文本

对齐规则说明:

  • :------- 左对齐(默认)
  • :------: 居中对齐
  • -------: 右对齐

表格中的格式化

表格单元格中可以使用其他 Markdown 语法:

| 功能 | 状态 | 优先级 | 负责人 |
|------|:----:|:------:|--------|
| 用户登录 | ✅ **完成** | 🔴 高 | [@张三](https://github.com/zhangsan) |
| 数据导出 | 🚧 *进行中* | 🟡 中 | [@李四](https://github.com/lisi) |
| 邮件通知 | ❌ 未开始 | 🟢 低 | `待分配` |
| API 文档 | ✅ **完成** | 🔴 高 | [@王五](https://github.com/wangwu) |

渲染效果:

功能状态优先级负责人
用户登录完成🔴 高@张三
数据导出🚧 进行中🟡 中@李四
邮件通知❌ 未开始🟢 低待分配
API 文档完成🔴 高@王五

复杂表格示例

让我们看一个更复杂的表格,展示项目的技术栈对比:

| 技术栈 | 前端框架 | 后端语言 | 数据库 | 部署方式 | 学习难度 | 社区活跃度 | 推荐指数 |
|:-------|:--------:|:--------:|:------:|:--------:|:--------:|:----------:|:--------:|
| **LAMP** | jQuery | PHP | MySQL | Apache | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
| **MEAN** | Angular | Node.js | MongoDB | Docker | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **Django** | Vue.js | Python | PostgreSQL | Heroku | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Rails** | React | Ruby | PostgreSQL | AWS | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| **Spring** | React | Java | MySQL | Kubernetes | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |

渲染效果:

技术栈前端框架后端语言数据库部署方式学习难度社区活跃度推荐指数
LAMPjQueryPHPMySQLApache⭐⭐⭐⭐⭐⭐⭐⭐
MEANAngularNode.jsMongoDBDocker⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
DjangoVue.jsPythonPostgreSQLHeroku⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
RailsReactRubyPostgreSQLAWS⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
SpringReactJavaMySQLKubernetes⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐

表格的最佳实践

1. 保持表格简洁

# ✅ 好的表格:信息清晰,列数适中
| 产品 | 价格 | 评分 |
|------|-----:|:----:|
| iPhone 15 | ¥5,999 | ⭐⭐⭐⭐⭐ |
| Samsung S24 | ¥4,999 | ⭐⭐⭐⭐ |

# ❌ 避免:列数过多,信息过载
| 产品 | 品牌 | 型号 | 颜色 | 存储 | 价格 | 发布日期 | 评分 | 销量 | 库存 |

2. 使用合适的对齐方式

| 项目 | 数量 | 金额 |
|:-----|-----:|-----:|
| 苹果 | 10 | ¥50.00 |
| 香蕉 | 5 | ¥15.00 |
| 总计 | 15 | ¥65.00 |
  • 文本内容:左对齐
  • 数字数据:右对齐
  • 状态标识:居中对齐

3. 添加表格标题

### 2024年第一季度销售数据

| 月份 | 销售额 | 增长率 |
|:----:|-------:|-------:|
| 1月 | ¥100万 | +5% |
| 2月 | ¥120万 | +20% |
| 3月 | ¥150万 | +25% |

使用编辑器插件快速生成表格

VS Code 插件推荐:

  1. Markdown All in One

    • 快捷键:Ctrl+Shift+P → "Markdown: Create Table"
    • 自动格式化表格
    • 支持表格导航
  2. Markdown Table

    • 提供表格编辑的可视化界面
    • 支持 CSV 导入
    • 自动对齐功能

在线表格生成器:

Excel/CSV 转 Markdown:

# 从 Excel 复制数据,使用在线工具转换
产品,价格,库存
iPhone,5999,100
Samsung,4999,80
Huawei,3999,120

# 转换后的 Markdown 表格
| 产品 | 价格 | 库存 |
|------|-----:|-----:|
| iPhone | 5999 | 100 |
| Samsung | 4999 | 80 |
| Huawei | 3999 | 120 |

4.2 任务列表:用 [ ][x] 管理待办事项

任务列表是 GitHub Flavored Markdown 的另一个实用扩展,特别适合项目管理和待办事项跟踪。

基本语法

- [ ] 未完成的任务
- [x] 已完成的任务
- [ ] 另一个未完成的任务
  - [ ] 子任务 1
  - [x] 子任务 2(已完成)
  - [ ] 子任务 3

渲染效果:

  • 未完成的任务
  • 已完成的任务
  • 另一个未完成的任务
    • 子任务 1
    • 子任务 2(已完成)
    • 子任务 3

语法要点

  1. 方括号内必须有空格或 x

    - [ ] 正确:空格表示未完成
    - [x] 正确:x 表示已完成
    - [X] 也正确:大写 X 也可以
    - [] 错误:缺少空格或 x
    - [v] 错误:不能使用其他字符
    
  2. 方括号前必须有连字符和空格

    - [ ] 正确的格式
    * [ ] 也可以使用星号
    + [ ] 或者加号
    [ ] 错误:缺少列表符号
    
  3. 支持嵌套

    - [ ] 主任务
        - [ ] 子任务(4个空格缩进)
            - [x] 子子任务(8个空格缩进)
    

实际应用场景

1. 项目开发清单

## 🚀 项目开发进度

### 前端开发
- [x] 项目初始化
- [x] 路由配置
- [ ] 用户界面设计
  - [x] 登录页面
  - [x] 首页布局
  - [ ] 用户个人中心
  - [ ] 设置页面
- [ ] 状态管理
- [ ] API 集成

### 后端开发
- [x] 数据库设计
- [x] 用户认证系统
- [ ] 业务逻辑实现
  - [x] 用户管理
  - [ ] 订单处理
  - [ ] 支付集成
- [ ] API 文档编写

### 测试与部署
- [ ] 单元测试
- [ ] 集成测试
- [ ] 性能测试
- [ ] 生产环境部署

2. 学习计划

## 📚 Markdown 学习计划

### 基础语法(第1周)
- [x] 标题和段落
- [x] 文本格式化
- [x] 列表
- [ ] 链接和图片

### 进阶语法(第2周)
- [ ] 表格
- [ ] 代码块
- [ ] 任务列表
- [ ] 数学公式

### 实践项目(第3周)
- [ ] 个人博客搭建
- [ ] 技术文档编写
- [ ] GitHub README 优化

3. 会议行动项

## 📋 会议行动项 - 2024年1月15日

### 立即执行(本周内)
- [x] @张三 整理用户需求文档
- [ ] @李四 完成技术方案评估
- [ ] @王五 提供UI设计稿

### 短期目标(2周内)
- [ ] 完成原型开发
- [ ] 进行用户测试
- [ ] 收集反馈意见

### 长期规划(1个月内)
- [ ] 产品正式发布
- [ ] 市场推广计划
- [ ] 用户培训材料

在 GitHub 中的特殊功能

在 GitHub Issues 和 Pull Requests 中,任务列表有特殊的交互功能:

1. 可点击切换状态

在 GitHub 网页界面中,你可以直接点击复选框来切换任务状态,无需编辑源码。

2. 进度统计

GitHub 会自动统计任务完成进度:

## 功能开发进度

- [x] 用户注册
- [x] 用户登录
- [ ] 密码重置
- [ ] 邮箱验证
- [ ] 用户资料编辑

<!-- GitHub 会显示:2 of 5 tasks completed -->

3. 与 Issues 关联

## 发布清单

- [x] 修复登录问题 (#123)
- [ ] 优化页面加载速度 (#124)
- [ ] 添加新功能 (#125)

最佳实践

1. 使用描述性的任务名称

# ✅ 好的任务描述
- [ ] 实现用户登录功能(包含表单验证和错误处理)
- [ ] 编写用户注册API文档(包含请求/响应示例)

# ❌ 不好的任务描述
- [ ] 做登录
- [ ] 写文档

2. 合理分解任务

# ✅ 合理的任务分解
- [ ] 用户管理模块
  - [ ] 用户注册功能
  - [ ] 用户登录功能
  - [ ] 密码重置功能
  - [ ] 用户资料管理

# ❌ 任务过于宽泛
- [ ] 完成整个用户系统

3. 添加负责人和截止时间

- [ ] 完成数据库设计 (@张三, 截止:2024-01-20)
- [ ] 实现API接口 (@李四, 截止:2024-01-25)
- [ ] 编写测试用例 (@王五, 截止:2024-01-30)

4.3 水平分割线:用于分隔内容区域

水平分割线用于在文档中创建视觉分隔,将不同的内容区域明确区分开来。

基本语法

Markdown 支持三种方式创建水平分割线:

# 使用三个或更多连字符
---

# 使用三个或更多星号
***

# 使用三个或更多下划线
___

渲染效果:




语法规则

  1. 至少需要三个符号

    ---  # 正确
    ---- # 也正确
    --   # 错误:少于三个
    
  2. 符号之间可以有空格

    - - -     # 正确
    * * *     # 正确
    _ _ _     # 正确
    
  3. 前后需要空行

    这是第一段内容。
    
    ---
    
    这是第二段内容。
    

使用场景

1. 分隔文档的主要部分

# 项目介绍

这里是项目的基本介绍...

---

# 安装指南

这里是安装步骤...

---

# 使用方法

这里是使用说明...

2. 分隔不同类型的内容

## 技术文章

这里是技术内容的正文...

***

## 作者信息

**作者**:张三  
**邮箱**:zhangsan@example.com  
**博客**:https://blog.example.com

***

## 相关文章

- [文章1](link1)
- [文章2](link2)
- [文章3](link3)

3. 在长文档中创建章节分隔

# 第一章:基础概念

内容...

___

# 第二章:实践应用

内容...

___

# 第三章:高级技巧

内容...

最佳实践

1. 保持一致性

在同一份文档中,建议使用同一种分割线样式:

# ✅ 推荐:统一使用 ---
第一部分内容

---

第二部分内容

---

第三部分内容

# ❌ 不推荐:混合使用
第一部分内容

---

第二部分内容

***

第三部分内容

___

2. 适度使用

# ✅ 合理使用:分隔主要部分
## 介绍
内容...

---

## 使用方法
内容...

# ❌ 过度使用:每个小节都分隔
## 介绍
内容...

---

### 子标题1
内容...

---

### 子标题2
内容...

3. 考虑替代方案

有时候使用标题层级比分割线更合适:

# 使用标题层级(推荐)
## 第一部分
内容...

## 第二部分
内容...

## 第三部分
内容...

# 使用分割线(当内容性质完全不同时)
## 正文内容
内容...

---

## 附录
附加信息...

4.4 综合练习:撰写项目需求文档

现在让我们通过一个完整的项目需求文档来练习本章学到的所有语法。

# 📱 移动端任务管理应用需求文档

**项目代号**:TaskMaster  
**版本**:v1.0  
**创建日期**:2024年1月15日  
**最后更新**:2024年1月20日

---

## 📋 项目概述

### 项目背景

随着远程工作的普及,团队协作和个人任务管理变得越来越重要。我们需要开发一款简洁高效的移动端任务管理应用,帮助用户更好地组织和跟踪工作进度。

### 目标用户

| 用户类型 | 占比 | 主要需求 | 使用场景 |
|:---------|:----:|:---------|:---------|
| **个人用户** | 60% | 个人任务管理 | 日常工作、学习计划 |
| **小团队** | 30% | 团队协作 | 项目管理、任务分配 |
| **企业用户** | 10% | 部门管理 | 大型项目、流程管控 |

### 核心价值主张

- 🎯 **简洁易用**:直观的界面设计,降低学习成本
- 🔄 **实时同步**:多设备数据同步,随时随地访问
- 👥 **团队协作**:支持任务分配和进度跟踪
- 📊 **数据洞察**:提供工作效率分析和报告

---

## 🎯 功能需求

### 核心功能清单

#### 用户管理
- [ ] 用户注册/登录
  - [ ] 邮箱注册
  - [ ] 手机号注册
  - [ ] 第三方登录(微信、QQ、Apple ID)
- [ ] 用户资料管理
  - [ ] 头像上传
  - [ ] 个人信息编辑
  - [ ] 密码修改
- [ ] 账户安全
  - [ ] 两步验证
  - [ ] 登录设备管理
  - [ ] 密码重置

#### 任务管理
- [ ] 任务创建与编辑
  - [x] 基础任务信息(标题、描述、截止时间)
  - [x] 任务优先级设置
  - [ ] 任务标签系统
  - [ ] 子任务支持
  - [ ] 文件附件
- [ ] 任务组织
  - [x] 项目分组
  - [ ] 任务列表
  - [ ] 看板视图
  - [ ] 日历视图
- [ ] 任务操作
  - [x] 任务状态切换
  - [ ] 任务复制/移动
  - [ ] 批量操作
  - [ ] 任务模板

#### 团队协作
- [ ] 团队管理
  - [ ] 创建/加入团队
  - [ ] 成员邀请
  - [ ] 权限管理
  - [ ] 角色分配
- [ ] 协作功能
  - [ ] 任务分配
  - [ ] 评论系统
  - [ ] @提醒功能
  - [ ] 活动动态

#### 数据分析
- [ ] 个人统计
  - [ ] 任务完成率
  - [ ] 工作时长统计
  - [ ] 效率趋势分析
- [ ] 团队报告
  - [ ] 项目进度报告
  - [ ] 成员工作量统计
  - [ ] 团队效率分析

### 功能优先级

| 功能模块 | 优先级 | 开发周期 | 依赖关系 |
|:---------|:------:|:--------:|:---------|
| 用户注册/登录 | 🔴 P0 | 1周 | 无 |
| 基础任务管理 | 🔴 P0 | 2周 | 用户系统 |
| 项目分组 | 🟡 P1 | 1周 | 任务管理 |
| 团队协作 | 🟡 P1 | 3周 | 用户系统 |
| 移动端适配 | 🟡 P1 | 2周 | 基础功能 |
| 数据分析 | 🟢 P2 | 2周 | 所有功能 |
| 高级搜索 | 🟢 P2 | 1周 | 任务管理 |
| API 开放 | 🔵 P3 | 1周 | 核心功能 |

---

## 🛠️ 技术规格

### 技术栈选择

| 层级 | 技术选择 | 理由 | 备选方案 |
|:-----|:---------|:-----|:---------|
| **前端** | React Native | 跨平台开发,代码复用率高 | Flutter, Native |
| **后端** | Node.js + Express | 开发效率高,生态丰富 | Python Django, Java Spring |
| **数据库** | MongoDB | 文档型数据库,适合敏捷开发 | PostgreSQL, MySQL |
| **缓存** | Redis | 高性能,支持多种数据结构 | Memcached |
| **部署** | Docker + AWS | 容器化部署,弹性扩容 | 阿里云, 腾讯云 |

### 性能要求

| 指标 | 目标值 | 测量方法 |
|:-----|:------:|:---------|
| 应用启动时间 | < 3秒 | 冷启动测试 |
| 页面加载时间 | < 2秒 | 网络监控 |
| API 响应时间 | < 500ms | 压力测试 |
| 并发用户数 | 10,000+ | 负载测试 |
| 数据同步延迟 | < 1秒 | 实时监控 |

### 兼容性要求

| 平台 | 最低版本 | 支持范围 |
|:-----|:--------:|:---------|
| **iOS** | iOS 12.0+ | iPhone 6s 及以上 |
| **Android** | Android 7.0+ | API Level 24+ |
| **Web** | Chrome 80+ | 现代浏览器 |

---

## 📱 用户界面设计

### 设计原则

- **简洁性**:界面元素精简,避免信息过载
- **一致性**:统一的视觉语言和交互模式
- **可访问性**:支持无障碍访问,考虑色盲用户
- **响应式**:适配不同屏幕尺寸和方向

### 主要页面结构

#### 首页(任务列表)
- [ ] 顶部导航栏
  - [ ] 用户头像
  - [ ] 搜索按钮
  - [ ] 通知图标
- [ ] 任务筛选器
  - [ ] 项目选择
  - [ ] 状态筛选
  - [ ] 优先级筛选
- [ ] 任务列表
  - [ ] 任务卡片设计
  - [ ] 滑动操作
  - [ ] 拖拽排序
- [ ] 底部操作栏
  - [ ] 添加任务按钮
  - [ ] 视图切换
  - [ ] 更多选项

#### 任务详情页
- [ ] 任务信息展示
  - [ ] 标题和描述
  - [ ] 截止时间
  - [ ] 优先级标识
  - [ ] 标签显示
- [ ] 操作按钮
  - [ ] 编辑任务
  - [ ] 删除任务
  - [ ] 分享任务
- [ ] 协作区域
  - [ ] 评论列表
  - [ ] 活动记录
  - [ ] 相关文件

### 色彩方案

| 用途 | 颜色代码 | 示例 |
|:-----|:--------:|:-----|
| **主色调** | #007AFF | 按钮、链接 |
| **辅助色** | #34C759 | 成功状态 |
| **警告色** | #FF9500 | 警告信息 |
| **错误色** | #FF3B30 | 错误状态 |
| **背景色** | #F2F2F7 | 页面背景 |
| **文字色** | #1C1C1E | 主要文字 |

---

## 🔒 安全与隐私

### 数据安全

- [ ] 数据加密
  - [x] HTTPS 传输加密
  - [ ] 数据库字段加密
  - [ ] 本地存储加密
- [ ] 访问控制
  - [x] JWT 身份验证
  - [ ] 权限分级管理
  - [ ] API 访问限制
- [ ] 安全审计
  - [ ] 操作日志记录
  - [ ] 异常行为监控
  - [ ] 定期安全扫描

### 隐私保护

| 数据类型 | 收集目的 | 保存期限 | 用户控制 |
|:---------|:---------|:--------:|:---------|
| **个人信息** | 账户管理 | 账户存续期 | 可编辑/删除 |
| **任务数据** | 功能提供 | 用户主动删除前 | 完全控制 |
| **使用统计** | 产品优化 | 12个月 | 可选择退出 |
| **设备信息** | 技术支持 | 6个月 | 自动收集 |

---

## 📈 项目计划

### 开发里程碑

#### 第一阶段:MVP 开发(4周)
- [x] 项目初始化和环境搭建
- [x] 用户注册/登录功能
- [ ] 基础任务 CRUD 操作
- [ ] 简单的任务列表界面
- [ ] 基础的数据同步

#### 第二阶段:核心功能(6周)
- [ ] 项目分组功能
- [ ] 任务优先级和标签
- [ ] 搜索和筛选
- [ ] 用户界面优化
- [ ] 性能优化

#### 第三阶段:协作功能(4周)
- [ ] 团队管理
- [ ] 任务分配
- [ ] 评论系统
- [ ] 通知推送

#### 第四阶段:高级功能(3周)
- [ ] 数据分析和报告
- [ ] 高级搜索
- [ ] 导入/导出功能
- [ ] API 开放

### 资源分配

| 角色 | 人数 | 主要职责 | 参与阶段 |
|:-----|:----:|:---------|:---------|
| **产品经理** | 1 | 需求管理、进度协调 | 全程 |
| **UI/UX 设计师** | 1 | 界面设计、用户体验 | 1-3阶段 |
| **前端开发** | 2 | 移动端应用开发 | 1-4阶段 |
| **后端开发** | 2 | 服务端开发、API设计 | 1-4阶段 |
| **测试工程师** | 1 | 功能测试、自动化测试 | 2-4阶段 |
| **DevOps** | 1 | 部署运维、监控 | 2-4阶段 |

---

## 🎯 成功指标

### 产品指标

| 指标 | 目标值 | 测量周期 |
|:-----|:------:|:--------:|
| **月活跃用户** | 10,000+ | 月度 |
| **用户留存率** | 70%+ | 7天留存 |
| **任务完成率** | 80%+ | 月度 |
| **用户满意度** | 4.5/5.0 | 季度调研 |
| **应用评分** | 4.0+ | App Store/Google Play |

### 技术指标

| 指标 | 目标值 | 监控方式 |
|:-----|:------:|:---------|
| **系统可用性** | 99.9% | 实时监控 |
| **平均响应时间** | < 500ms | APM 工具 |
| **错误率** | < 0.1% | 日志分析 |
| **数据同步成功率** | 99.5% | 业务监控 |

---

## 📞 联系信息

### 项目团队

| 角色 | 姓名 | 邮箱 | 微信 |
|:-----|:-----|:-----|:-----|
| **项目经理** | 张三 | zhangsan@company.com | zhang_san_pm |
| **技术负责人** | 李四 | lisi@company.com | li_si_tech |
| **设计负责人** | 王五 | wangwu@company.com | wang_wu_design |

### 相关文档

- [ ] [技术架构设计文档](./tech-architecture.md)
- [ ] [UI/UX 设计规范](./design-guidelines.md)
- [ ] [API 接口文档](./api-documentation.md)
- [ ] [测试计划文档](./test-plan.md)
- [ ] [部署运维手册](./deployment-guide.md)

---

> **文档状态**:草稿版本  
> **下次评审**:2024年1月25日  
> **批准状态**:待产品委员会审批

练习要点分析

这个综合练习展示了本章所有语法的实际应用:

  1. 表格的多样化使用

    • 用户类型分析表
    • 功能优先级表
    • 技术栈对比表
    • 性能指标表
    • 项目团队表
  2. 任务列表的层次化组织

    • 功能需求清单
    • 开发里程碑
    • 界面设计任务
    • 相关文档清单
  3. 分割线的合理使用

    • 分隔文档的主要章节
    • 区分不同类型的内容
    • 创建清晰的视觉层次
  4. 格式化元素的综合运用

    • 表格中的文本强调
    • 任务列表中的链接
    • emoji 增强可读性

本章小结

在这一章中,我们深入学习了 Markdown 中组织结构化数据的高级语法:

主要内容回顾

  1. 表格语法

    • 基本表格:| 列1 | 列2 |
    • 对齐控制::---, :---:, ---:
    • 表格中的格式化
    • 编辑器插件的使用
  2. 任务列表

    • 基本语法:- [ ]- [x]
    • 嵌套任务列表
    • GitHub 中的特殊功能
    • 项目管理应用
  3. 水平分割线

    • 三种语法:---, ***, ___
    • 使用场景和最佳实践
    • 与标题层级的配合

最佳实践总结

  • 表格设计:保持简洁,合理对齐,添加标题
  • 任务管理:描述清晰,合理分解,标注负责人
  • 内容分隔:适度使用,保持一致,考虑替代方案
  • 综合运用:结合多种语法,创建专业文档

下一步学习

在下一章中,我们将学习如何在 Markdown 中展示代码,包括行内代码和代码块的语法,以及如何使用语法高亮来提升代码的可读性。这对于技术文档编写尤其重要。


练习建议:尝试为你正在进行的项目创建一份需求文档或计划清单,使用本章学到的表格、任务列表和分割线来组织内容。


mp.weixin.qq.com_cgi-bin_settingpage_t=setting_index&action=index&token=2028891395&lang=zh_CN.png