基本准则

  1. 简洁明了:避免冗长表达,用最短的句子传递核心信息 ✅
  2. 逻辑清晰:段落间用过渡句衔接,确保读者能顺畅跟随思路 ➡️
  3. 术语统一:对专业名词保持固定写法(如“HTTP”而非“http”或“Http”) 🔍

格式规范

  • 标题层级:使用 ####### 表示不同层级标题,避免过度嵌套
  • 代码块:用 ```markdown 语法包裹代码,关键词需替换空格为下划线(如 Python_示例
  • 列表排版:无序列表用 -,有序列表用 1.,保持缩进一致

扩展阅读

想了解更多关于技术文档的写作技巧?可以参考:course/style_guide

写作_技巧
Markdown_格式