| name | docx-content-cleaner |
| description | Analyzes and cleans up markdown artifacts (like **bold**, *italic*, [links](url)) inside existing .docx files, converting them into proper Word formatting (runs with styles). |
DOCX Content Cleaner
When to Use
- A .docx file contains literal markdown symbols (e.g.,
**text**, ### Header).
- You need to "sanitize" or "beautify" a document generated from markdown that didn't parse formatting correctly.
- You want to ensure that all "pseudo-formatting" in text is converted to native Word styles.
How it Works
- Extraction: Uses
python-docx to iterate through all paragraphs and runs.
- Analysis: Uses regex to find markdown patterns inside the text of each run.
- Transformation:
- Splices runs to isolate the marked-up text.
- Applies the corresponding Word formatting (Bold, Italic, Style) to the isolated text.
- Removes the markdown symbols.
- Repack: Saves the modernized .docx.
Requirements
- Python with
python-docx library.
Usage
Run the provided script in resources/markdown_to_docx_fixer.py:
python resources/markdown_to_docx_fixer.py <input.docx> <output.docx>