Capitalization
This page includes guidelines for capitalization in documentation. Some examples of capitalization include titles, headings, and data types.
note
For details on formatting text elements in documentation, source code, or UIs, see Text Element Formatting.
Titles and headings
This section describes how to format titles and headings in documentation.
Title and heading format
| Heading type | Markdown syntax | Details |
|---|---|---|
| Heading 1 (title) | # | Title-style capitalization |
| Heading 2 | ## | Sentence-style capitalization |
| Heading 3 | ### | Sentence-style capitalization |
| Heading 4 | #### | Sentence-style capitalization |
How you write a title or heading depends on what the content below the title or heading will be. Keep in mind the following:
- Use title-style capitalization in titles: In title-style capitalization, most major words are capitalized.
- Capitalize the first and last words, nouns, pronouns, verbs, adjectives, adverbs, and any words that are five letters or longer.
- Articles (like "a" and "the"), coordinating conjunctions (like "and" or "but"), and prepositions with fewer than five letters (like "in" or "on") are usually lowercase unless they start or end the title.
- Use sentence-style capitalization in headings: In sentence-style capitalization, only the first word of the sentence (or title) and any proper nouns are capitalized. This approach mimics standard sentence structure, making it simpler and typically easier to read.
tip
For details on which grammar structures to follow for titles and headings, see Grammar.