markdownlisted

# Markdown Lint Automated markdown validation and fixing using markdownlint-cli2. ## Workflow Overview ```text 1. Run auto-fix → markdownlint-cli2 --fix <file> 2. Check remaining → markdownlint-cli2 <file> 3. Fix manually → str_replace for structural issues 4. Verify → markdownlint-cli2 <file> (should show 0 errors) ``` **Expected results**: Auto-fix resolves 70-90% of issues. Remaining 3-5 issues require manual correction. ## Basic Commands ```bash # Auto-fix single file markdownlint-cli2 --fix document.md # Check file markdownlint-cli2 document.md # Multiple files markdownlint-cli2 --fix file1.md file2.md # All markdown in directory markdownlint-cli2 --fix "**/*.md" # With custom config markdownlint-cli2 --config .markdownlint.json document.md ``` ## File Paths ```bash # Uploaded files markdownlint-cli2 --fix /mnt/user-data/uploads/document.md # Working directory markdownlint-cli2 --fix /home/claude/document.md # Output to user cp /path/to/fixed.md /mnt/user-data/outputs/ ``` ## Manual Fixes Required Auto-fix cannot resolve these issues - they need Claude's judgment: ### MD025 - Multiple H1 Headers **Why**: Requires understanding document hierarchy **Fix**: Convert extra H1s to appropriate level ```markdown # Main Title # Second Title → Change to: ## Second Title ``` ### MD036 - Emphasis as Header **Why**: Requires determining author intent **Fix**: Replace bold/italic with proper header ```markdown **Section Title** → Change to