explaingit

sparanoid/chinese-copywriting-guidelines

Analysis updated 2026-06-24

15,405Audience · writerComplexity · 1/5Setup · easy

TLDR

Reference document defining standards for mixing Chinese text with Latin characters, numbers, and punctuation. Aimed at consistent web and product copy.

Mindmap

mindmap
  root((copy-guidelines))
    Inputs
      Chinese text
      Latin words
      Numbers and units
    Outputs
      Spacing rules
      Punctuation rules
      Casing rules
    Use Cases
      Web copy review
      Style guide
      Auto formatter
    Tech Stack
      Markdown
      JavaScript
      Python
      Go
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Adopt as a written style guide for a Chinese-language website or product

USE CASE 2

Wire up a spacing-fix tool in CI to enforce Chinese-English spacing on Markdown files

USE CASE 3

Settle internal debates about how to format Chinese text mixed with English brand names

What is it built with?

MarkdownJavaScriptPythonGo

How does it compare?

sparanoid/chinese-copywriting-guidelineshammerspoon/hammerspoonsimulatedgreg/electron-vue
Stars15,40515,40615,406
LanguageObjective-CJavaScript
Setup difficultyeasyeasymoderate
Complexity1/53/53/5
Audiencewriterdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

In plain English

Chinese Copywriting Guidelines is a reference document (available in English, Traditional Chinese, and Simplified Chinese) that defines standards for mixing Chinese text with Latin characters, numbers, and punctuation in written communication. The goal is to improve the readability and visual consistency of Chinese-language content, particularly on websites and in product copy, and to reduce the effort teams spend debating formatting choices. The guidelines cover several specific areas. On spacing: a space should be added between Chinese characters and English letters, between Chinese characters and numbers, and between numbers and units (like "10 Gbps"), but not between full-width punctuation marks and other characters. On punctuation: avoid repeating punctuation marks for emphasis, and use full-width Chinese punctuation (not half-width ASCII equivalents) when writing Chinese sentences. On capitalization: proper nouns like product and brand names should use their officially defined casing. The guidelines also note that the CSS property text-spacing from the CSS Text Module Level 4 spec could eventually automate some of these spacing rules, but since it is not yet widely supported, manual spacing remains necessary. The document includes a list of tools across many programming languages, including JavaScript, Python, Go, Ruby, and others, that can automatically apply some of these spacing corrections to existing text, and notes a number of websites (including Apple's regional sites, Microsoft, and LeanCloud) that follow these conventions.

Copy-paste prompts

Prompt 1
Summarize the spacing rules from chinese-copywriting-guidelines in a one-page cheat sheet
Prompt 2
Write a script that scans my Markdown blog and adds spaces between Chinese and Latin characters per these rules
Prompt 3
Apply the chinese-copywriting-guidelines to this paragraph and explain each change
Prompt 4
Compare chinese-copywriting-guidelines to Apple's Chinese typography rules

Frequently asked questions

What is chinese-copywriting-guidelines?

Reference document defining standards for mixing Chinese text with Latin characters, numbers, and punctuation. Aimed at consistent web and product copy.

How hard is chinese-copywriting-guidelines to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is chinese-copywriting-guidelines for?

Mainly writer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub sparanoid on gitmyhub

Verify against the repo before relying on details.