> For the complete documentation index, see [llms.txt](https://oodlz-ai-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oodlz-ai-studio.gitbook.io/docs/outbound-agents/awareness/2-articles/gutenberg-formatting.md).

# Gutenberg Formatting

Final markdown converted to native WordPress Gutenberg blocks — branded H2 labels, styled pull-quotes, auto-TOC, FAQ accordions, smart image distribution all applied in code.

> **Native WordPress blocks with the brand's full design system baked in — no CSS overrides, no manual formatting after publish.**

Generic AI writers output raw HTML, broken shortcodes, or basic block markup with none of the brand's visual identity. The Oodlz Gutenberg formatter converts the final article markdown into native WordPress blocks with the complete brand design system applied in code — pull-quotes, TOC, FAQ accordions, image spacing, colour-block spacing, all consistently styled across every post.

## How It Works

After the link pipeline finishes, the formatter takes the article markdown and rewrites it as native Gutenberg blocks. Each transformation applies a specific brand-style rule:

* **Branded H2 labels** — every H2 heading gets an accent label rendered above it.
* **Styled pull-quotes** — accent background, oversized quote icon, correct padding.
* **Auto-generated Table of Contents** — placed after the intro section, built from H2 and H3 headings.
* **FAQ accordions** — FAQ sections render in a branded 25/75 column layout, each question collapsing into a styled accordion.
* **Smart image distribution** — body word count and colour-block count are pre-scanned to calculate ideal spacing thresholds. Images snap to H2 boundaries at the soft threshold; mid-section force-placement fires at the hard threshold. Images never land within 150 words of the FAQ.
* **Adjacency rules** — no 2 colour blocks (image, table, pull-quote) ever appear adjacent. Spacers and separators are enforced between them.

Every post exits the formatter as valid, renderable Gutenberg HTML — ready to display in WordPress with no manual formatting.

## What You Get

* Native Gutenberg blocks matching the brand's design system — pull-quotes, TOC, FAQ accordions all consistently styled.
* Smart image distribution — images placed at calculated spacing, never clustered, never adjacent to other colour blocks.
* 150-word safe zone before the FAQ — images don't intrude into the FAQ visually.
* Auto-generated TOC — built from headings, no manual maintenance.
* FAQ accordions in branded 25/75 layout — collapsible questions, styled consistently.
* Adjacency rules enforced — image, table, pull-quote never appear back to back.