format_markdown

format_markdown

Linting Compliance

• Blank lines: One around headings, lists, tables, code blocks
• Single newline: File must end with exactly one newline
• No multiple blanks: Maximum one consecutive blank line
• Consistent bullets: Use - for all unordered lists
• Fenced code: Always use language identifier
• Table alignment: Use :---: for center, :--- for left, ---: for right
• Header levels: Don't skip levels (H1 → H2 → H3, not H1 → H3)
• List indentation: 2 spaces for nested items
• List marker spacing: Use 1 space after list markers
• No bare URLs: Wrap in angle brackets or use reference links
• No trailing punctuation: In headers

Best Practices

• Descriptive links: Meaningful text, not "click here"
• Alt text: Always for images
• Consistent emphasis: **bold** and *italic* only
• Table headers: Always include