Purpose
Prevent awkward line breaks inside single‑word CamelCase company/brand names in Markdown by inserting a zero‑width joiner (ZWJ, HTML entity ). This keeps the visual brand token intact across wraps without introducing visible characters.
The rule
-
Insert a single ZWJ at the primary internal case change of single‑word CamelCase names.
-
Use the HTML entity form in Markdown source.
-
Do not change casing, spacing, or punctuation.
Canonical examples (use exactly as shown):
-
HubSpot
-
LinkedIn
-
RapidSOS
-
EisnerAmper
-
FrankCrum
-
HiHello
-
iCapture
-
SnapAddy
Scope and exclusions
Apply ZWJ only to visible text. Never insert ZWJ in:
-
URLs, email addresses, file paths, code blocks, inline code, IDs, or form inputs
-
Image alt attributes that must match file names or IDs
-
Multi‑word brand names separated by spaces or hyphens (no ZWJ needed)
-
Ordinary capitalized words without internal case change (e.g., “Salesforce”)
How to apply by context
-
Headings (H1–H6): Apply ZWJ in the visible brand token.
-
Body copy: Apply on first and subsequent mentions for consistency.
-
Link text: Apply in the visible anchor text; never modify the URL.
-
Tables: Apply inside cell text; keep header and body cells consistent.
| Context | Apply ZWJ? | Notes |
|---|---|---|
| Headings | Yes | Preserve branding in prominent text. |
| Body copy | Yes | Use consistently throughout the article. |
| Link text | Yes | ZWJ in anchor text only; URL remains untouched. |
| URLs/code | No | Never alter URLs, code, IDs, or email addresses. |
| Tables | Yes | Apply in both headers and cells for uniformity. |
Do and Don’t
-
Do: Insert exactly one at the main internal case change (e.g., HubSpot).
-
Do: Keep the entity invisible; avoid adding spaces around it.
-
Don’t: Add ZWJ to non‑CamelCase words or multi‑word names (e.g., “Bank of America”).
-
Don’t: Insert ZWJ inside URLs, code, or data fields.
Implementation tips
-
Authoring: Type “” directly in Markdown where the split occurs (e.g., “HubSpot”).
-
Consistency: If a page contains mixed usage, normalize all instances to the ZWJ form.
-
QA: Search for single‑word tokens matching CamelCase patterns (e.g., /[A-Z][a-z]+[A-Z][A-Za-z]+/) and confirm ZWJ insertion in visible text only.
-
Accessibility: ZWJ is non‑printing and should not affect screen readers; verify with standard readers in regression checks.