基础语法 / 列表

列表

列表最适合处理“这周要做什么”“发布前按什么顺序检查”这类信息。好的列表能直接变成行动,不只是排版。

无序列表

当顺序不重要,只需要把项目拆开列清楚时,使用无序列表:

- 首页改写成任务导向
- Intro 页面加入导航
- 深色模式下修复文字对比度

有序列表

当步骤必须照顺序执行,例如本地验证到发布流程,使用有序列表:

1. 本地预览页面
2. 检查链接和截图
3. 执行 npm run build
4. 发布到 GitHub Pages

嵌套列表

如果你需要把任务进一步拆层级,可以通过缩进组织子项:

- 本周文档任务
  - 重写标题与链接页
  - 统一示例口吻
- 发布前检查
  1. 运行 npm run build
  2. 确认英文入口正常

效果预览

本周文档任务:

  • 重写首页与入门页
  • 替换高频语法页示例
  • 复查语言切换与深色模式

发布顺序:

  1. 本地检查视觉和链接
  2. 执行构建
  3. 确认产物路径
  4. 推送更新

写作建议

  • 集合类信息用无序列表,流程类信息用有序列表,不要混着写。
  • 每一项尽量以动词或明确名词开头,避免“其他”“补充说明”这类含糊表述。
  • 嵌套层级控制在两层左右,太深就该考虑拆成小节或表格。
  • 如果列表已经在表达状态,后续要跟踪进度时可以升级成任务列表。

评论

评论区暂未开放。

需要先为这个仓库启用 GitHub Discussions,并完成 giscus 配置后,评论功能才可用。