gitwtfhub

wtf is chinese-copywriting-guidelines?

sparanoid/chinese-copywriting-guidelines — explained in plain English

Analysis updated 2026-06-24

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

TL;DR

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

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

MarkdownJavaScriptPythonGo

How it stacks up

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 spin it up?

Difficulty · easy Time to first run · 5min

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.