---
description: Write and review Cloudflare content so the whole site reads as if one careful author wrote it, from contributing through planning, style, and build.
title: Style Guide
image: https://developers.cloudflare.com/og-docs.png
---

[Skip to content](#main-content)

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/style-guide/llms.txt  
> Use this file to discover all available pages before exploring further.

# Style Guide

Last updated Aug 24, 2026|Copy as Markdown|[View as Markdown](https://e8aee267.previews.developers.cloudflare.com/style-guide/index.md)|[Agent setup](https://e8aee267.previews.developers.cloudflare.com/agent-setup/)

Use this guide whenever you write or review Cloudflare content, whether it lives in the documentation or in the product dashboard. Following it is what keeps the whole site reading as though one careful author wrote every page, which also makes the content clearer for readers and simpler to translate.

The guide is organized around the way you actually work, in five stages: contribute a change, plan the content, write it in the Cloudflare style, build the page, and, for the Cloudflare team, run the site.

## Contribute

Start here. Make a change and get it merged.

### [Contributions](https://e8aee267.previews.developers.cloudflare.com/style-guide/contributions/)

Open an issue or raise a pull request, then follow it through the review that merges it.

## Plan your content

Decide what kind of page you are writing and where it lives.

### [Content strategy](https://e8aee267.previews.developers.cloudflare.com/style-guide/documentation-content-strategy/)

Choose a content type, structure the page, and place it in the information architecture.

### [API content](https://e8aee267.previews.developers.cloudflare.com/style-guide/api-content-strategy/)

Follow the conventions for documenting endpoints, parameters, and resources.

## Style and grammar

Write the page in the house voice, grammar, and formatting.

### [Voice and tone](https://e8aee267.previews.developers.cloudflare.com/style-guide/style-and-grammar/voice-and-tone/)

Write in the Cloudflare house voice and tone.

### [Accessibility](https://e8aee267.previews.developers.cloudflare.com/style-guide/style-and-grammar/accessibility/)

Write content that everyone can read and use.

### [Grammar](https://e8aee267.previews.developers.cloudflare.com/style-guide/style-and-grammar/grammar/)

Apply the rules for parts of speech, punctuation, and capitalization.

### [Formatting](https://e8aee267.previews.developers.cloudflare.com/style-guide/style-and-grammar/formatting/)

Format dates, numbers, code, lists, tables, and UI elements consistently.

## Build the page

Author the page in MDX, set its metadata, and add components.

### [Markdown and MDX](https://e8aee267.previews.developers.cloudflare.com/style-guide/build-the-page/markdown-and-mdx/)

Learn the MDX syntax, how to import components, and how to escape special characters.

### [Frontmatter](https://e8aee267.previews.developers.cloudflare.com/style-guide/build-the-page/frontmatter/)

Declare the required and optional metadata that every page carries.

### [Components](https://e8aee267.previews.developers.cloudflare.com/style-guide/build-the-page/components/)

Assemble pages from the MDX components that add buttons, tabs, and more.

## How we docs

How the Cloudflare team runs the site. This section is Cloudflare-specific internal process.

### [How we docs](https://e8aee267.previews.developers.cloudflare.com/style-guide/how-we-docs/)

See how the team handles the site framework, redirects, links, metadata, AI, and video.

Was this helpful?

YesNo

## On this page

[![](https://e8aee267.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://e8aee267.previews.developers.cloudflare.com/)

```json
{"@context":"https://schema.org","@type":"WebPage","@id":"https://developers.cloudflare.com/style-guide/#page","headline":"Style Guide · Cloudflare Style Guide","description":"Write and review Cloudflare content so the whole site reads as if one careful author wrote it, from contributing through planning, style, and build.","url":"https://developers.cloudflare.com/style-guide/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-24","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```