Word Text Style Cleaner

What It Solves

Word documents often accumulate unrelated style entries: heading 6-9, TOC1-TOC9, annotations, residual font styles, Excel import leftovers, and unused Title, Subtitle, or list paragraph styles. Removing them manually is slow and risks deleting Normal text, table, hyperlink, or actually referenced styles.

How It Works

Word Text Style Cleaner processes .docx files or folders through an unpack → analyze → clean → repack workflow. It scans document.xml for styles actually used in the document, then removes redundant entries using a default keep policy:
- Kept: Normal, Default Paragraph Font, heading 1-5, common table styles, No List, hyperlinks, header/footer styles.
- Removed: heading 6-9, TOC styles, annotation/comment styles, font5-font12, xl65-xl79, and other unused residual styles.

Boundaries and Notes

This is useful when the Word style panel is cluttered or when a document should keep only body text and headings. It overwrites the original file by default, so back it up first. If you need a narrower policy, such as keeping only heading 1-3, update the BASE_KEEP_IDS set in the script. Also adjust the top-level constants if the paths to unpack.py or pack.py change.