文档教程【免费下载链接】chinese-copywriting-guidelinesChinese copywriting guidelines for better written communication中文文案排版指北项目地址https://gitcode.com/gh_mirrors/ch/chinese-copywriting-guidelines点击查看免费下载统一中文文案、排版的相关用法降低团队成员之间的沟通成本增强网站气质。这篇技术指南围绕当前仓库中的《中文文案排版指北》README.md展开系统梳理中英文混排时必须遵守的空格、标点、全角半角与名词大小写规范并给出完整正误示例对照。读者阅读完成后将掌握一套可以直接应用于产品文案、技术文档、官网与社区 UGC 场景的排版检查清单同时了解如何借助仓库内的工程化配置Markdown lint、Crowdin 多语言维护把规范固化到日常写作流程中。项目是什么chinese-copywriting-guidelines 是一份以 Markdown 文档形式维护的中文文案排版规范仓库目标是把「统一中文文案、排版的相关用法」这一抽象要求拆解成一条条可判定的具体规则。它既面向个人写作者也面向需要团队协作、多人共同产出内容的网站与产品团队其价值在于降低沟通成本团队内不再为「这里要不要加空格」「这里用全角还是半角」反复争论直接以规则为准增强网站气质一致的排版让页面观感更专业、可读性更强规则可机器校验文档末尾附有 pangu、autocorrect 等工具生态规则可以转化为自动化的格式化与 lint 流程。仓库采用 MIT 协议见 LICENSE并通过 crowdin.yml 配置了多语言翻译工作流将 README.md 作为源文件同步产出 英文版 与 简体中文版 等多个语言版本。空格中英文混排的第一道门槛「有研究显示打字的时候不喜欢在中文和英文之间加空格的人感情路都走得很辛苦有七成的比例会在 34 岁的时候跟自己不爱的人结婚而其余三成的人最后只能把遗产留给自己的猫。毕竟爱情跟书写都需要适时地留白。与大家共勉之。」——vinta/paranoid-auto-spacing这段引文出自 pangu 工具的作者意在用调侃的方式说明中英文之间适时留白是排版美感的基础。规则全集如下。中英文之间需要增加空格正确在 LeanCloud 上数据存储是围绕AVObject进行的。错误在LeanCloud上数据存储是围绕AVObject进行的。在 LeanCloud上数据存储是围绕AVObject进行的。注意第二种错误只在一侧加空格也是不合格的空格必须同时出现在中英文交界的两侧。完整的正确用法一个自然段内连续命中多处交界的情况在 LeanCloud 上数据存储是围绕AVObject进行的。每个AVObject都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的你不需要在每个AVObject上提前指定存在哪些键只要直接设定对应的 key-value 即可。例外「豆瓣FM」等产品名词按照官方所定义的格式书写不要机械地在「豆瓣」与「FM」之间强加空格。中文与数字之间需要增加空格正确今天出去买菜花了 5000 元。错误今天出去买菜花了 5000元。今天出去买菜花了5000元。数字与单位之间需要增加空格正确我家的光纤入屋宽带有 10 GbpsSSD 一共有 20 TB。错误我家的光纤入屋宽带有 10GbpsSSD 一共有 20TB。例外度数与百分比与数字之间不需要空格正确角度为 90° 的角就是直角。新 MacBook Pro 有 15% 的 CPU 性能提升。错误角度为 90 ° 的角就是直角。新 MacBook Pro 有 15 % 的 CPU 性能提升。规律可以这样记忆凡是「计量单位」这类独立成词的符号Gbps、TB、kg、km数字与单位之间要留空格凡是「紧贴数字的符号」这类度数°、百分号%等按排版惯例与数字连写的不加空格。全角标点与其他字符之间不加空格正确刚刚买了一部 iPhone好开心错误刚刚买了一部 iPhone 好开心刚刚买了一部 iPhone 好开心中文的全角标点逗号、句号、感叹号等应当紧贴前一个字符后面也不需要额外补空格因为全角字符本身已占据足够宽度。用text-spacing来挽救CSS Text Module Level 4 的text-spacing和 Microsoft 的-ms-text-autospace可以在 CSS 层面自动为中英文之间增加空白。但该规范目前并未普及而且在 macOS、iOS、Windows 等非 Web 应用的用户界面中并不存在这个特性。因此结论是不要把自动化排版寄托在浏览器特性上请继续保持随手加空格的习惯。从 CHANGELOG.md 可以看到这条关于text-spacing的提示是在 0.0.10 版本2018-10-14时补充进文档的属于对「中英文之间加空格」主规则的现实性补充说明。标点符号不重复使用标点符号虽然中国大陆的标点符号用法允许重复使用标点符号但是这么做会破坏句子的美观性。正确德国队竟然战胜了巴西队她竟然对你说「喵」错误德国队竟然战胜了巴西队德国队竟然战胜了巴西队她竟然对你说「喵」她竟然对你说「喵」「感叹号 问号」组合即 interrobang 式用法表达强烈疑问即可连续堆叠感叹号或问号属于排版失控。文档中给出的「」「」连写是允许的但「」这类重复堆叠则明确禁止。全角和半角字符宽度的选择如果不熟悉全角全形与半角半形符号的概念可参考维基百科「全形和半形」条目。规则层面文档给出三条。使用全角中文标点正确嗨你知道嘛今天前台的小妹跟我说「喵」了哎核磁共振成像NMRI是什么原理都不知道JFGI错误嗨! 你知道嘛? 今天前台的小妹跟我说 喵 了哎!嗨!你知道嘛?今天前台的小妹跟我说喵了哎!核磁共振成像 (NMRI) 是什么原理都不知道? JFGI!核磁共振成像(NMRI)是什么原理都不知道?JFGI!中文句子内部的感叹号、问号、括号、引号必须使用全角形式。错误示例展示了三种常见翻车方式使用半角标点!、?、、半角括号前后加空格、以及全角括号缺失。例外中文句子内夹有英文书籍名、报刊名时不应借用中文书名号应以英文斜体表示。数字使用半角字符正确这个蛋糕只卖 1000 元。错误这个蛋糕只卖 元。例外在设计稿、宣传海报中如出现极少量数字的情形时为方便文字对齐可以使用全角数字。遇到完整的英文整句、特殊名词其内容使用半角标点正确乔布斯那句话是怎么说的「Stay hungry, stay foolish.」推荐你阅读Hackers Painters: Big Ideas from the Computer Age非常地有趣。错误乔布斯那句话是怎么说的「Stay hungrystay foolish。」推荐你阅读《HackersPaintersBig Ideas from the Computer Age》非常的有趣。规则边界很清晰中文语境使用全角标点英文整句与英文书名使用半角标点。英文引文内部不能混入中文逗号、句号英文书名用斜体而非中文书名号同时、:等符号也保持半角。名词大小写与缩写专有名词使用正确的大小写大小写相关用法原属于英文书写范畴不属于本 wiki 讨论内容这里只对部分易错用法进行简述。正确使用 GitHub 登录我们的客户有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。错误使用 github 登录使用 GITHUB 登录使用 Github 登录使用 gitHub 登录使用 gんĤЦ8 登录我们的客户有 github、foursquare、microsoft corporation、google、facebook, inc.。我们的客户有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。我们的客户有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。我们的客户有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。我们的客户有 gんĤЦ8、ouЯƧquгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。错误示例覆盖了四类典型问题全小写、全大写、大小写混排错乱Github、gitHub、MicroSoft以及用同形异义字符homoglyph伪装的品牌名。最后一条是在提醒不要用字符替换玩花样品牌名应始终以官方标准形式书写。注意当网页中需要配合整体视觉风格而出现全部大写小写的情形时HTML 中请使用标准的大小写规范进行书写并通过text-transform: uppercase;text-transform: lowercase;对表现层进行定义。也就是说源文本永远保持标准大小写视觉效果交给 CSS——这与「语义与表现分离」的前端最佳实践一致。不要使用不地道的缩写正确我们需要一位熟悉 TypeScript、HTML5至少理解一种框架如 React、Next.js的前端开发者。错误我们需要一位熟悉 Ts、h5至少理解一种框架如 RJS、nextjs的 FED。缩写要「地道」TypeScript 不要写成 TsHTML5 不要写成 h5React 不要写成 RJSNext.js 不要写成 nextjs前端开发者不要用 FED 这类圈内黑话替代。从 CHANGELOG.md 看这条规则自 0.0.5 版本2015-07-08起就以「avoid unidiomatic jargons」的形式进入文档且文档维护过程中曾专门做过「avoid slangs」0.0.8与「avoid personal writing style」0.0.4等措辞修正可见这类示例一直在持续打磨。争议带有个人色彩、但从语法上都正确以下用法略带有个人色彩即无论是否遵循下述规则从语法的角度来讲都是正确的。是否采纳取决于团队审美。链接之间增加空格用法推荐请 提交一个 issue 并分配给相关同事。访问我们网站的最新动态请 点击这里 进行订阅对比用法请提交一个 issue并分配给相关同事。访问我们网站的最新动态请点击这里进行订阅在 Markdown / HTML 中[链接文字]与前后中文之间是否加空格不影响渲染但文档倾向在链接两侧保留空格使中文与可点击文字之间有视觉喘息。简体中文使用直角引号用法推荐「老师『有条不紊』的『紊』是什么意思」对比用法“老师‘有条不紊’的‘紊’是什么意思”简体中文惯用弯引号“ ” ‘ ’但文档建议在简体中文中也采用直角引号「」『』层次嵌套更清晰外层「」内层『』视觉上与繁体语境也一致。需要说明的是README.md 本身为繁体中文版本其「简体中文使用直角引号」条目是面向简体写作场景的建议简体中文版的对应内容见 README.zh-Hans.md。工具生态把规则变成自动化规范最终要落到执行。文档末尾整理了当前社区中可用于中文文案排版校验与格式化的工具以下为完整清单链接信息源自 README.md 工具章节| 仓库 | 系列 | 语言 | | --- | -- | --- | | pangu.js | pangu | JavaScript | | pangu-go | pangu | Go | | pangu.java | pangu | Java | | pangu.py | pangu | Python | | pangu.rb | pangu | Ruby | | pangu.php | pangu | PHP | | pangu.vim | pangu | Vim | | vue-pangu | pangu | Vue.js (Web Converter) | | intellij-pangu | pangu | Intellij Platform Plugin | | autocorrect | autocorrect | Rust, WASM, CLI tool | | autocorrect-node | autocorrect | Node.js | | autocorrect-py | autocorrect | Python | | autocorrect-rb | autocorrect | Ruby | | autocorrect-java | autocorrect | Java | | autocorrect-go | autocorrect | Go | | autocorrect-php | autocorrect | PHP | | autocorrect-vscode | autocorrect | VS Code Extension | | autocorrect-idea-plugin | autocorrect | Intellij Platform Plugin | | jxlwqq/chinese-typesetting | other | PHP | | sparanoid/space-lover | other | PHP (WordPress) | | sparanoid/grunt-auto-spacing | other | Node.js (Grunt) | | hjiang/scripts/add-space-between-latin-and-cjk | other | Python | | hustcc/hint | other | Python | | n0vad3v/Tekorrect | other | Python |两大系列的分工可以这样理解pangu 系列以「自动在 CJK 与字母/数字之间插入空格」为核心适合在发布管线中批量格式化文本覆盖 JavaScript、Go、Java、Python、Ruby、PHP、Vim、Vue.js 与 IntelliJ 平台autocorrect 系列功能更全面的中文文案格式化与 lint 工具提供 Rust/WASM/CLI、Node.js、Python、Ruby、Java、Go、PHP 以及 VS Code、IntelliJ 插件形态可以像 ESLint 一样嵌入编辑器与 CIother 系列包含 WordPress 插件space-lover、Grunt 构建任务grunt-auto-spacing、Python 脚本add-space-between-latin-and-cjk、hint、Tekorrect等场景化工具。选择策略建议单文件快速处理用 pangu 系列需要工程化集成、支持 lint 报告时优先 autocorrect静态博客或传统 CMS 环境可考虑 other 系列。工程化保障这份文档仓库自身怎么保证排版正确该仓库不仅「教」别人排版自身也配置了排版质量检查值得借鉴Markdown 风格 lint在 package.json 中npm test执行的是remark .即用 remark-cli 对全部 Markdown 文件做 lint配置了remark-preset-lint-consistent、remark-preset-lint-recommended以及remark-lint-list-item-indent列表项缩进统一为空格等插件。这意味着 README 本身的书写风格如列表缩进、格式一致性也是受 CI 约束的——文档发布前会先通过 lint 才能合入多语言维护根目录的 crowdin.yml 声明了source: /README.md、translation: /README.%locale%.md的翻译映射配合 README 顶部的语言切换链接英文、繁体、简体说明规范在持续进行社区化翻译多语言版本同步演进依赖与版本治理仓库通过 renovate.json 自动跟踪依赖更新CHANGELOG.md 记录了从 0.0.12014-07-01至今的每次规则增删与措辞修订例如 0.0.2 新增数字全角/半角用法、0.0.3 简化规则与章节顺序调整、0.0.4 补充度数与百分比空格用法、0.0.8 新增「链接前后空格」规则、0.0.10 新增text-spacing提示与更多反面示例。这套「文档即代码」的治理方式与文档正文提倡的排版规范形成了呼应规范本身也应当是经过 lint、可维护、可翻译的。谁在这样做业界实践参考文档列出了一些在产品文案Copywriting或用户生成内容UGC上落实此类排版规范的网站链接信息源自 README.md 对应章节网站文案UGCApple 中国是N/AApple 香港是N/AApple 台湾是N/AMicrosoft 中国是N/AMicrosoft 香港是N/AMicrosoft 台湾是N/ALeanCloud是N/AV2EX是是Apple4us是N/ARuby China是是少数派是N/A可以看到Apple 与 Microsoft 的官方中文站、LeanCloud、少数派等以「官方文案」为主要内容的站点严格执行排版规范而 V2EX、Ruby China 这类社区站点连用户生成内容也纳入了排版约束。如果你的产品同时有官方文案与用户评论两种内容形态这份表格提供了很好的分级参考文案必须严格UGC 尽力引导。参考文献文档引用的外部参考资料包括ThoughtCo. 的英语大写规则指南、Wikipedia 的 Letter case 与全角半形条目、Oxford Dictionaries 与 Purdue OWL 的标点指南、wikiHow 的英文标点使用教程、openSUSE 的格式规范、维基百科的引号与疑问惊叹号条目等可用于进一步核对规则背后的语言学依据完整条目见 README.md 参考文献章节英文版见 README.en.md。落地建议如何在团队中推行结合全文规则给出一个可执行的落地顺序先把规则文档讲给团队以 README.md 为基线团队内对齐「空格、标点、全角半角、名词大小写」四类规则有分歧的条目链接空格、直角引号按「争议」章节的精神讨论后定稿接入自动化工具根据技术栈选择 autocorrect 或 pangu 系列接入编辑器和 CI让机器先过一遍硬规则人工只处理例外如产品名词、设计稿中对齐需求用真实文案做对照检查用文档中的「正确/错误」示例改造自己产品的存量文案形成团队内部的正反例集文档本身也纳入规范治理借鉴本仓库的做法给文案文档配置 lint 与版本管理让规范随产品迭代持续演进。赞分享文档教程【免费下载链接】chinese-copywriting-guidelinesChinese copywriting guidelines for better written communication中文文案排版指北项目地址https://gitcode.com/gh_mirrors/ch/chinese-copywriting-guidelines点击查看免费下载相关推荐用 x402-axios 为 Axios 接入 x402 支付协议构建自动处理 402 响应的 TypeScript 支付客户端用 x402 axios 为 Axios 接入 x402 支付协议构建自动处理 402 响应的 TypeScript 支付客户端 导读 x402 是一个构建在文档教程终极中文文案排版指北从空格到标点的完整教程终极中文文案排版指北从空格到标点的完整教程 中文文案排版指北是一份帮助你规范中文写作格式的实用指南旨在统一中文文案、排版的相关用法降低团队成员之间的沟通成空格规范详解中英文排版的关键细节空格规范详解中英文排版的关键细节 本文全面解析了中英文排版中的空格规范涵盖了中英文之间、数字与中文之间、数字与单位之间以及全角标点符号的空格处理原则。通过详文档教程上一篇Firebase Kotlin SDK路线图未来功能预测与社区贡献指南下一篇Ant Design Vue Button 组件完全指南类型、属性、事件与源码实现解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
