playbooks

home / skills / christopheryeo / claude-skills / change-headings

change-headings skill

/change-headings

This skill converts document headings to normal paragraphs while preserving size, weight, color, and inline formatting.

npx playbooks add skill christopheryeo/claude-skills --skill change-headings

Review the files below or copy the command above to add this skill to your agents.

Files (1)
skill.md
1.4 KB
---
name: change-headings
description: Converts all headings in a document into normal paragraphs while keeping the original font size, weight, color, and other formatting intact.
---

# Heading-to-Paragraph Normalizer

You specialize in flattening styled headings into standard paragraphs without altering their visual appearance.
Use this when a document needs uniform text styles while preserving the original heading look (size, weight, color, bold/italic, and inline formatting).

## Required Input
- **Document text/content** with headings styled using heading levels (e.g., Heading 1–6).

## Execution Steps
1. **Identify headings**
   - Detect all heading levels in the provided document.
   - Record each heading's font size, weight, color, alignment, and inline formatting (bold, italic, underline, links, etc.).

2. **Convert styles**
   - Change each heading element to normal body/paragraph style.
   - Reapply the captured formatting so the visual appearance (size, weight, color, inline styles) matches the original heading.
   - Maintain spacing, lists, and indentation around converted headings.

3. **Quality checks**
   - Ensure no heading style remains; all are standard paragraphs.
   - Preserve document structure and order; do not rewrite content.
   - Keep hyperlinks and inline formatting unchanged.

## Output
Return the updated document text/content with headings converted to normal paragraphs that retain the original font size and formatting.

Overview

This skill converts all headings in a document into standard paragraphs while preserving their original visual appearance. It flattens heading elements but keeps font size, weight, color, alignment, and inline formatting intact. The result is uniform paragraph styling that looks identical to the original headings.

How this skill works

The skill scans the document for heading elements (Heading 1–6), captures each heading's visual attributes and inline formatting, and replaces the heading element with a normal paragraph element. Captured attributes — font size, weight, color, alignment, bold/italic/underline, links and other inline styles — are reapplied to the paragraph so the appearance remains unchanged. It also preserves surrounding spacing, lists, indentation, and document order while ensuring no heading styles remain.

When to use it

  • Preparing documents for systems that don't support semantic headings but must keep the same look
  • Standardizing text styles before exporting to formats or tools that strip heading semantics
  • Cleaning files for print or layout workflows where headings cause unwanted automatic behaviors
  • Removing heading-based formatting for content migration while maintaining visual fidelity
  • Ensuring visual consistency when automated heading styles break layout or templates

Best practices

  • Run a quick backup of the original document before conversion
  • Verify inline elements like links and annotations remain clickable after conversion
  • Check list and table contexts where headings might affect flow or numbering
  • Confirm paragraph spacing and indentation match expected layout after conversion
  • Test on a sample document when integrating into automated pipelines

Example use cases

  • Convert a multi-level technical spec so all headings become paragraphs but keep the same sizes and boldness for print-ready output
  • Normalize a marketing brochure that used heading styles causing template overrides in the CMS
  • Prepare an academic paper for a publisher that requires no semantic headings but preserved typography
  • Migrate content to a platform that strips heading tags while maintaining the original look
  • Flatten headings in a collaborative doc before exporting to a tool that misinterprets heading structure

FAQ

Will links and inline formatting be preserved?

Yes. Links, bold, italic, underline, and other inline styles are kept and reapplied to the new paragraph elements.

Does this change font size or visual layout?

No. The skill preserves font size, weight, color, alignment, and spacing so the document looks the same after conversion.