Markdown.instructions

---
applyTo: '**/*.md'
description: 'Markdown formatting standards'
---

# Markdown Style Guidelines

Consistent Markdown formatting for documentation files.

## Blank Lines

- Use single blank lines between sections and elements
- Never use multiple consecutive blank lines
- Headings, lists, and code blocks must have a blank line above and below

## Headings

- Use ATX style (`#`) not setext (underlines)
- Use consistent heading levels (don't skip levels)
- Start with a single H1 (`#`) for the document title
- Use sentence case for headings
- Include a space after `#` characters
- No trailing punctuation (colons, periods, etc.)
- Avoid duplicate heading text within the same document

## Lists

- Use `-` for unordered lists
- Use sequential numbering for ordered lists (`1.`, `2.`, `3.`, etc.)
- Use 2 spaces for nested list indentation