{"slug":"content-formatter-documentation","title":"Content Formatter: Raw Text to Structured Document","tags":["formatting","structure","headings","content-structure","readability"],"agent_summary":"Converts raw unstructured text into a properly formatted document with heading hierarchy, lists, tables, and callouts. Used when raw content exists but lacks structure for web publishing or SOP documentation.","trigger_phrases":["format this content","structure this text","add headings to this","make this readable","clean up this content","organize this article","content formatting"],"runnable":true,"markdown":"\n# Content Formatter: Raw Text to Structured Document\n\nTurns raw, unstructured text into a publish-ready document. This is not editing — the words stay as close to original as possible. This is structure surgery.\n\n---\n\n## When to Use\n\n- Raw transcripts, voice-to-text dumps, or brainstorm notes need structure\n- Client provided content that needs to be web-formatted before publishing\n- SOP documentation that came in as bullet lists with no hierarchy\n- Blog draft written as one long paragraph block\n\n---\n\n## Step 1: Intent Classification\n\nBefore adding structure, classify what type of document this is. Structure follows intent.\n\n| Document Type | Primary Structure Element |\n|--------------|--------------------------|\n| How-to guide | Numbered steps with H3 per step |\n| Listicle | H2 per item, supporting text below |\n| Explainer | Definition first, then H2 sections |\n| Case study | Problem → Solution → Result flow |\n| Reference doc | H2 categories with table or list under each |\n| Opinion piece | H2 per main argument, no numbered lists |\n\n---\n\n## Step 2: Heading Hierarchy Rules\n\n**H1** — One per document. The topic. Matches the primary keyword.\n\n**H2** — Major sections. Each H2 should answer a distinct question or cover a distinct subtopic. If you have 10+ H2s, most should be H3s.\n\n**H3** — Sub-sections under H2. Use when an H2 section has 3+ distinct sub-points.\n\n**H4** — Rarely needed. Use only for deep technical documentation with nested categories.\n\n**Test:** Can a reader get the full outline of the document by reading only H1, H2, and H3? If yes — structure is correct.\n\n---\n\n## Step 3: List Formatting Rules\n\n**Use numbered lists when:**\n- Sequence matters (steps must happen in order)\n- Ranking or priority matters\n- There are fewer than 10 items\n\n**Use bulleted lists when:**\n- Order doesn't matter\n- Listing features, options, or attributes\n- 3-10 items\n\n**Never use lists when:**\n- Fewer than 3 items (write as a sentence instead)\n- Items need full-paragraph explanation each (use H3s instead)\n- Content is narrative or story-driven\n\n---\n\n## Step 4: Table Formatting Rules\n\nAdd tables when content compares 3+ items across 2+ attributes.\n\n**Required table elements:**\n- Header row with clear column labels\n- Consistent units (don't mix \"$\" in some cells and \"dollars\" in others)\n- 3-10 rows (more = use pagination or split table)\n- No merged cells in standard web content\n\n**When NOT to use tables:**\n- Only 2 items to compare (use a side-by-side paragraph instead)\n- Data is sequential (use numbered list)\n- Only 1 attribute being compared (use a list)\n\n---\n\n## Step 5: Callout Blocks\n\nUse callout boxes (blockquotes or styled divs) to highlight:\n\n- **Pro tip:** Actionable shortcut the reader might miss\n- **Warning:** Common mistake or risk\n- **Key stat:** Single number that anchors an argument\n- **Definition:** Technical term needing brief explanation\n\nOne callout per major section maximum. Too many callouts = nothing stands out.\n\n---\n\n## Step 6: Formatting QA Checklist\n\nBefore delivery:\n\n- [ ] One H1, matches primary keyword\n- [ ] No H2 with fewer than 2 sentences below it (or it should be an H3)\n- [ ] No paragraph longer than 5 sentences (web standard)\n- [ ] No sentence longer than 30 words (readability)\n- [ ] Lists have 3-10 items (fewer = sentence, more = H3 sub-sections)\n- [ ] Tables have header row and consistent column formatting\n- [ ] No orphaned bullet (single bullet = sentence, not list)\n- [ ] Bold used only for key terms and takeaways, not decoration\n\n---\n\n## SOP-Specific Formatting Standards\n\nWhen formatting SOP documentation specifically:\n\n- Every procedure gets a numbered list with verb-first steps\n- Decision points get a table: condition in column 1, action in column 2\n- Prerequisites get a callout block at the top\n- Expected outputs listed at the end under \"Deliverables\"\n- Owners identified: \"Who does this: [Role]\"\n\n#content-sop #formatting #structure #readability\n","html":"<h1>Content Formatter: Raw Text to Structured Document</h1>\n<p>Turns raw, unstructured text into a publish-ready document. This is not editing — the words stay as close to original as possible. This is structure surgery.</p>\n<hr>\n<h2>When to Use</h2>\n<ul>\n<li>Raw transcripts, voice-to-text dumps, or brainstorm notes need structure</li>\n<li>Client provided content that needs to be web-formatted before publishing</li>\n<li>SOP documentation that came in as bullet lists with no hierarchy</li>\n<li>Blog draft written as one long paragraph block</li>\n</ul>\n<hr>\n<h2>Step 1: Intent Classification</h2>\n<p>Before adding structure, classify what type of document this is. Structure follows intent.</p>\n<p>| Document Type | Primary Structure Element |\n|--------------|--------------------------|\n| How-to guide | Numbered steps with H3 per step |\n| Listicle | H2 per item, supporting text below |\n| Explainer | Definition first, then H2 sections |\n| Case study | Problem → Solution → Result flow |\n| Reference doc | H2 categories with table or list under each |\n| Opinion piece | H2 per main argument, no numbered lists |</p>\n<hr>\n<h2>Step 2: Heading Hierarchy Rules</h2>\n<p><strong>H1</strong> — One per document. The topic. Matches the primary keyword.</p>\n<p><strong>H2</strong> — Major sections. Each H2 should answer a distinct question or cover a distinct subtopic. If you have 10+ H2s, most should be H3s.</p>\n<p><strong>H3</strong> — Sub-sections under H2. Use when an H2 section has 3+ distinct sub-points.</p>\n<p><strong>H4</strong> — Rarely needed. Use only for deep technical documentation with nested categories.</p>\n<p><strong>Test:</strong> Can a reader get the full outline of the document by reading only H1, H2, and H3? If yes — structure is correct.</p>\n<hr>\n<h2>Step 3: List Formatting Rules</h2>\n<p><strong>Use numbered lists when:</strong></p>\n<ul>\n<li>Sequence matters (steps must happen in order)</li>\n<li>Ranking or priority matters</li>\n<li>There are fewer than 10 items</li>\n</ul>\n<p><strong>Use bulleted lists when:</strong></p>\n<ul>\n<li>Order doesn't matter</li>\n<li>Listing features, options, or attributes</li>\n<li>3-10 items</li>\n</ul>\n<p><strong>Never use lists when:</strong></p>\n<ul>\n<li>Fewer than 3 items (write as a sentence instead)</li>\n<li>Items need full-paragraph explanation each (use H3s instead)</li>\n<li>Content is narrative or story-driven</li>\n</ul>\n<hr>\n<h2>Step 4: Table Formatting Rules</h2>\n<p>Add tables when content compares 3+ items across 2+ attributes.</p>\n<p><strong>Required table elements:</strong></p>\n<ul>\n<li>Header row with clear column labels</li>\n<li>Consistent units (don't mix \"$\" in some cells and \"dollars\" in others)</li>\n<li>3-10 rows (more = use pagination or split table)</li>\n<li>No merged cells in standard web content</li>\n</ul>\n<p><strong>When NOT to use tables:</strong></p>\n<ul>\n<li>Only 2 items to compare (use a side-by-side paragraph instead)</li>\n<li>Data is sequential (use numbered list)</li>\n<li>Only 1 attribute being compared (use a list)</li>\n</ul>\n<hr>\n<h2>Step 5: Callout Blocks</h2>\n<p>Use callout boxes (blockquotes or styled divs) to highlight:</p>\n<ul>\n<li><strong>Pro tip:</strong> Actionable shortcut the reader might miss</li>\n<li><strong>Warning:</strong> Common mistake or risk</li>\n<li><strong>Key stat:</strong> Single number that anchors an argument</li>\n<li><strong>Definition:</strong> Technical term needing brief explanation</li>\n</ul>\n<p>One callout per major section maximum. Too many callouts = nothing stands out.</p>\n<hr>\n<h2>Step 6: Formatting QA Checklist</h2>\n<p>Before delivery:</p>\n<ul>\n<li>[ ] One H1, matches primary keyword</li>\n<li>[ ] No H2 with fewer than 2 sentences below it (or it should be an H3)</li>\n<li>[ ] No paragraph longer than 5 sentences (web standard)</li>\n<li>[ ] No sentence longer than 30 words (readability)</li>\n<li>[ ] Lists have 3-10 items (fewer = sentence, more = H3 sub-sections)</li>\n<li>[ ] Tables have header row and consistent column formatting</li>\n<li>[ ] No orphaned bullet (single bullet = sentence, not list)</li>\n<li>[ ] Bold used only for key terms and takeaways, not decoration</li>\n</ul>\n<hr>\n<h2>SOP-Specific Formatting Standards</h2>\n<p>When formatting SOP documentation specifically:</p>\n<ul>\n<li>Every procedure gets a numbered list with verb-first steps</li>\n<li>Decision points get a table: condition in column 1, action in column 2</li>\n<li>Prerequisites get a callout block at the top</li>\n<li>Expected outputs listed at the end under \"Deliverables\"</li>\n<li>Owners identified: \"Who does this: [Role]\"</li>\n</ul>\n<p>#content-sop #formatting #structure #readability</p>\n"}