中文文档编写规范（转载）：这篇文章转载自 GitHub，总结了中文文档的写作风格、标点符号、数值规范等方面的注意事项，对提高中文文档的质量和可读性有很大帮助。

中文文档是指使用中文作为主要语言的书面材料，包括但不限于书籍、报告、论文、文章、网页、说明书等。中文文档的编写需要遵循一定的规范，以保证内容的准确性、清晰性和一致性。本文将介绍一些中文文档编写的基本原则和常见问题，希望对中文文档的作者和读者有所帮助。

## 写作风格

写作风格是指作者在表达思想和信息时所采用的语言方式和技巧。不同的写作风格会给读者不同的感受和印象，因此选择合适的写作风格是很重要的。一般来说，中文文档应该遵循以下几个原则：

- **简洁明了**：尽量使用简单、直接、通俗的词语和句子，避免使用冗长、复杂、晦涩的表达方式，删除不必要的修饰语和重复语。
- **规范统一**：尽量使用规范的语法和用法，避免使用方言、俚语、缩略语等非标准的语言形式，保持词汇、术语、格式等方面的一致性。
- **客观准确**：尽量使用客观、公正、真实的信息和数据，避免使用主观、偏颇、虚假的观点和论据，注明信息和数据的来源和引用方式。
- **逻辑清晰**：尽量使用有条理、有层次、有逻辑的结构和顺序，避免使用杂乱无章、跳跃无序、前后矛盾的组织和安排，明确主题和目的，突出重点和关键。

## 标点符号

标点符号是指用来分隔或补充文字内容的符号，如逗号、句号、引号等。标点符号的使用可以帮助读者理解文字内容的意思和关系，因此正确使用标点符号是很重要的。一般来说，中文文档应该遵循以下几个原则：

- **使用全角标点**：全角标点是指占用一个字符宽度的标点符号，如“，”、“。”、“””等。全角标点与中文字符相匹配，可以保持文字内容的整齐美观。除非特殊情况（如在英文或数字中间插入标点），否则应该使用全角标点而不是半角标点（如“,”、“.”、“"”等）。
- **使用中文标点**：中文标点是指符合中文语言习惯和规范的标点符号，如顿号、“《》”、“（）”等。中文标点与中文语法相匹配，可以保持文字内容的正确表达。除非特殊情况（如引用外文或数学公式），否则应该使用中文标点而不是英文标点（如逗号、“<>”、“()”等）。
- **使用合适的标点**：合适的标点是指根据文字内容的意思和关系选择恰当的标点符号，如逗号用于分隔并列或从属成分，句号用于结束一个完整的句子，引号用于标示引用或特殊的词语等。合适的标点可以帮助读者理解文字内容的含义和关联。应该根据具体情况使用合适的标点，避免使用不恰当或过多的标点。

## 数值规范

数值是指用来表示数量、度量、比例等概念的符号，如数字、单位、百分比等。数值的使用可以帮助读者获取文字内容的具体信息和数据，因此规范使用数值是很重要的。一般来说，中文文档应该遵循以下几个原则：

- **使用阿拉伯数字**：阿拉伯数字是指由0到9组成的十进制数字系统，如“123”、“456”、“789”等。阿拉伯数字与中文字符相兼容，可以保持文字内容的简洁清晰。除非特殊情况（如在古文或诗歌中使用），否则应该使用阿拉伯数字而不是中文数字（如“一二三”、“四五六”、“七八九”等）。
- **使用国际单位**：国际单位是指由国际单位制（SI）规定的度量单位，如“米”、“千克”、“秒”等。国际单位与中文字符相协调，可以保持文字内容的规范统一。除非特殊情况（如在历史或地方性的文档中使用），否则应该使用国际单位而不是其他单位（如“尺”、“斤”、“刻”等）。
- **使用逗号分隔**：逗号分隔是指在数值中每隔三位插入一个逗号，如“1,234”、“56,789”、“123,456,789”等。逗号分隔可以帮助读者快速识别数值的大小和数量级。除非特殊情况（如在小数或科学计数法中使用），否则应该使用逗号分隔而不是其他方式（如空格或点号）。

以上就是本文介绍的中文文档编写规范的一些要点，希望对中文文档的编写和阅读有所帮助。如果您想了解更多关于中文文档编写规范的内容，请参考[原文]或其他相关资料。

: https://github.com/ruanyf/document-style-guide/blob/master/docs/text.md