摘要:如何让技术文章看起来更加专业、严谨且易读?本文详细整理了小宝科技站的中文写作格式规范,涵盖中英文空格混排、专有名词拼写、标点符号使用以及行文风格等核心准则,助你写出排版优雅的技术文档。
不知道大家平时在浏览各种技术博客、文档或者公众号文章的时候,有没有遇到过这样的情况:
有的文章字里行间没有一个空格,中英文和数字挤成一团,让人看得眼睛酸痛;有的文章则是满屏的「苹果 (Apple)」、「微软 (Microsoft)」,带着英文后缀,割裂了中文阅读的连贯性;还有的文章里标点符号全半角混杂,一会儿是弯引号 "",一会儿是方头括号 【】,整体排版极其杂乱。
排版,往往是读者对一篇文章的第一印象。优雅的排版不仅看着赏心悦目,更能让知识的传递事半功倍。为了保证小宝科技站所有技术文章的排版质量,我们特别制定了这套「中文写作格式与排版规范」。本规范是小宝科技站唯一的排版与写作标准。
一、 空格使用:字里行间的呼吸感
中英文和数字混排时,如果没有合理的空格,字符会显得非常拥挤。在汉字与英文、数字之间加入适当的空格,能为排版提供自然的「呼吸感」。
1. 中英文之间加空格
中文字符与英文字母、单词或英文专有名词之间,必须添加一个半角空格。
💡 提示
正确:使用 GitHub 管理代码,能让团队协作更轻松。
错误:使用GitHub管理代码,能让团队协作更轻松。
2. 中文与数字之间加空格
中文与阿拉伯数字之间,也必须添加一个半角空格。
💡 提示
正确:今天温度是 25 度,湿度达到了 60%。
错误:今天温度是25度,湿度达到了60%。
3. 数字与单位符号之间不加空格
数字与常用的单位符号(如百分号 %、温度符号 °C、存储单位 GB 等)之间通常不加空格。除非是完整的英文单位单词,此时应按英文规范加空格。
- 正确示例:
25°C、60%、100GB、5 meters - 错误示例:
25 °C、60 %、100 GB
二、 专有名词:技术写作的严谨底线
技术名词的大小写体现了一名写作者的专业程度。专有名词(包括品牌名、产品名、技术名词等)必须严格遵循官方规定的大小写格式,严禁随意拼写。
1. 常见专有名词正确示范
- 品牌与公司:
Apple、Microsoft、Google、GitHub、OpenAI - 产品名称:
iPhone、iPad、MacBook、Windows、ChatGPT、Claude - 技术与工具:
JavaScript、TypeScript、Python、React、Vue.js、Node.js - 缩写与通用概念:
AI、API、URL、HTML、CSS、JSON、Markdown
2. 典型错误对比
| 规范格式 (Correct) | 常见错误格式 (Incorrect) |
|---|---|
| GitHub | github / Github |
| JavaScript / TypeScript | javascript / typescript / Js |
| Node.js | nodejs / Nodejs |
| iPhone / MacBook | iphone / macbook / Macbook |
| AI / API / URL | ai / api / url |
三、 标点符号:规范的边界线
标点符号的使用同样需要遵循严格的中文排版标准。胡乱使用英文标点或格式不对的符号,会大大降低文章的质感。
1. 统一使用直角引号
在中文内容中进行引用或强调时,必须使用直角引号 「」,而非传统的弯引号 “”,也绝对不能使用英文双引号 ""。
- 正确:他说:「这是最好的时代。」
- 错误:他说“这是最好的时代” 或 他说"这是最好的时代"
2. 英文句子的标点边界
当引号内部是完整的英文句子时,应该使用半角标点符号。
- 正确:我很喜欢那句格言:「Less is more.」
- 错误:我很喜欢那句格言:「Less is more。」
3. 全角与半角的区分
中文内容一律使用全角标点符号(,。!?;:)。唯一可以例外的是:当括号内的内容全部为纯英文或纯数字时,允许并推荐使用半角括号 (),其他情况一律使用全角括号 ()。
4. 严禁在正文中使用方头括号 【】
正文中禁止使用 【】 来标记功能、UI 元素或起强调作用。需要强调时请统一使用直角引号 「」。
💡 提示
唯一的例外:文章标题开头的分类前缀,允许且必须使用方头括号,例如本站的系列文章 【OpenClaw 教程】快速入门。
5. 省略号规范
中文内容中的省略号必须使用标准的六点省略号 ……(在标准中文输入法下通常通过 Shift + 6 输入)。严禁连打三个英文句点 ... 作为中文省略号。
- 正确:关于这个话题,他还有很多话想说……
- 错误:关于这个话题,他还有很多话想说...
四、 行文的自然与连贯
我们倡导自然、亲切、通顺的写作风格,拒绝生硬和冗余的表述,确保文章读起来流畅自然。
避免冗余的括号英文附注
在中文日常交流或技术写作中,除非有极其必要的学术或指代需要,严禁在常用名词后面带着括号附注英文全称,这会严重割裂中文的阅读连贯性。
💡 提示
正确:建议开启系统自带的存储感知或磁盘清理功能进行瘦身。
错误:建议开启系统自带的存储感知 (Storage Sense) 或磁盘清理 (Disk Cleanup) 功能进行瘦身。
如果确实需要提到英文原名(例如介绍某个新的开发工具),也应以流畅的方式自然融入正文中,而不是机械地使用括号附加。
五、 写在最后
规范的排版,不仅是对读者的尊重,更是写作者对自身文字品质的执着追求。遵循这套排版规范,能够让我们的知识分享更显诚意与专业度。
未来小宝科技站发布的所有新文章,都将严格把控这一标准。让我们一起用干净利落的排版,写出更优质的技术内容!
加载评论中……