基础语法 / 列表
列表
列表最适合处理“这周要做什么”“发布前按什么顺序检查”这类信息。好的列表能直接变成行动,不只是排版。
无序列表
当顺序不重要,只需要把项目拆开列清楚时,使用无序列表:
- 首页改写成任务导向
- Intro 页面加入导航
- 深色模式下修复文字对比度 有序列表
当步骤必须照顺序执行,例如本地验证到发布流程,使用有序列表:
1. 本地预览页面
2. 检查链接和截图
3. 执行 npm run build
4. 发布到 GitHub Pages 嵌套列表
如果你需要把任务进一步拆层级,可以通过缩进组织子项:
- 本周文档任务
- 重写标题与链接页
- 统一示例口吻
- 发布前检查
1. 运行 npm run build
2. 确认英文入口正常 效果预览
本周文档任务:
- 重写首页与入门页
- 替换高频语法页示例
- 复查语言切换与深色模式
发布顺序:
- 本地检查视觉和链接
- 执行构建
- 确认产物路径
- 推送更新
写作建议
- 集合类信息用无序列表,流程类信息用有序列表,不要混着写。
- 每一项尽量以动词或明确名词开头,避免“其他”“补充说明”这类含糊表述。
- 嵌套层级控制在两层左右,太深就该考虑拆成小节或表格。
- 如果列表已经在表达状态,后续要跟踪进度时可以升级成任务列表。
评论
评论区暂未开放。
需要先为这个仓库启用 GitHub Discussions,并完成 giscus 配置后,评论功能才可用。