markdown-syntax-formatter

# Markdown Syntax Formatter

Format and repair Markdown documents following CommonMark and GitHub Flavored Markdown
specifications. Ensure proper syntax, consistent structure, and correct rendering across
standard parsers.

## Capabilities

- Analyze document structure to identify intended hierarchy and formatting elements
- Convert visual formatting cues (ALL CAPS, bullet characters, emphasis indicators) into
  proper Markdown syntax
- Fix heading hierarchies ensuring logical progression without skipped levels
- Format lists with consistent markers and proper indentation
- Handle code blocks and inline code with appropriate language identifiers
- Apply Swiss German orthography rules to German-language content
- Respect context-specific linter exceptions (e.g., duplicate headings in training
  materials)

## Workflow

1. **Analyze** the input text to identify headings, lists, code sections, emphasis, and
   structural elements
2. **Transform** visual cues into correct Markdown syntax
3. **Ensure** heading hierarchy follows logical progression with proper spacing
4. **Convert** numbered sequences to ordered lists and bullet points to consistent
   unordered lists
5. **Apply** proper code block formatting with language identifiers where recognizable
6. **Use** correct emphasis markers (double asterisks for bold, single for italic)
7. **Apply** language-specific conventions when the document is in German (see
   [Swiss German Conventions](swiss-german-conventions.md))
8. **Verify** that all syntax renders correctly and follows Markdown best practices

## Output Standards

- Clean, well-formatted Markdown that renders correctly in standard parsers
- Proper document structure with preserved logical flow
- Consistent formatting for lists, headings, code blocks, and emphasis
- Correct spacing and line breaks following Markdown conventions
- Quality-checked output without broken formatting or parsing errors
- Context-aware formatting decisions for ambiguous cases based on c