markdown-optimization

Markdown optimization analyzes your documents for verbose prose, duplication, and structural inefficiency, then applies compaction patterns like converting text to tables, extracting examples, and consolidating sections to shrink file size while preserving clarity and maintainability.

Progressive disclosure and structural validation detect poorly organized content, remove redundancy, and suggest reorganization to make documents more scannable. The optimization pass converts lengthy explanations into bullet points and tables, improving navigation and update-ability.

Yes. The skill validates links and audits table of contents health to ensure all navigation elements point to valid sections, catching structural errors that degrade document usability.

The optimization analysis identifies redundant content across your Markdown files or within large documents, flagging opportunities to consolidate repeated information and improve maintainability.

Convert prose to tables when documentation contains repetitive, comparable data—such as parameter lists, feature comparisons, or step sequences—to improve scannability and reduce word count without losing information.

Yes. You can run the optimization pass on individual files or entire folder structures to generate compact, well-structured versions across your entire documentation set.