# markdown-formatter > Format and beautify markdown documents - Author: Yves Lepère - Repository: YvesThenElse/TeamForge - Version: 20260107110434 - Stars: 0 - Forks: 0 - Last Updated: 2026-02-06 - Source: https://github.com/YvesThenElse/TeamForge - Web: https://mule.run/skillshub/@@YvesThenElse/TeamForge~markdown-formatter:20260107110434 --- --- name: markdown-formatter description: Format and beautify markdown documents allowed-tools: Read, Write, Edit category: Documentation tags: - markdown - formatting - documentation --- # Markdown Formatting Skill This skill helps you create, format, and improve markdown documents. ## Capabilities - Format markdown documents according to best practices - Convert other formats to markdown - Create tables of contents - Fix markdown syntax errors - Improve document structure and readability ## Usage Examples ### Format Documents Automatically format markdown files with consistent styling, proper heading hierarchy, and clean syntax. ### Create TOC Generate tables of contents for long markdown documents with proper linking. ### Syntax Fixing Identify and fix markdown syntax issues like broken links, malformed tables, or incorrect list formatting. ## Best Practices - Use consistent heading levels - Ensure proper blank lines between sections - Format code blocks with appropriate language tags - Use relative links for internal navigation - Keep line length reasonable for readability