Systematically fix linting issues in markdown files using markdownlint-cli2. This skill provides structured workflows to diagnose, fix, and verify markdown formatting issues with special focus on MD029 errors.
You can install this plugin from any of these themed marketplaces. Choose one, add it as a marketplace, then install the plugin.
Choose your preferred installation method below
A marketplace is a collection of plugins. Every plugin gets an auto-generated marketplace JSON for individual installation, plus inclusion in category and themed collections. Add a marketplace once (step 1), then install any plugin from it (step 2).
One-time setup for access to all plugins
When to use: If you plan to install multiple plugins now or later
Step 1: Add the marketplace (one-time)
/plugin marketplace add https://claudepluginhub.com/marketplaces/all.jsonRun this once to access all plugins
Step 2: Install this plugin
/plugin install markdown-linter-fixer-2@allUse this plugin's auto-generated marketplace JSON for individual installation
When to use: If you only want to try this specific plugin
Step 1: Add this plugin's marketplace
/plugin marketplace add https://claudepluginhub.com/marketplaces/plugins/markdown-linter-fixer-2.jsonStep 2: Install the plugin
/plugin install markdown-linter-fixer-2@markdown-linter-fixer-2A Claude Agent Skill that systematically fixes linting issues in markdown files using markdownlint-cli2.
This skill provides Claude with structured workflows to diagnose, fix, and verify markdown formatting issues across projects. It focuses on the most common real-world issues, especially MD029 errors caused by improper indentation of content within ordered lists.
The Markdown Linter Fixer skill enables Claude to:
Markdown linting errors are common in documentation, especially when combining:
The MD029 error (ordered list item prefix) is particularly common and confusing. This skill includes a comprehensive guide explaining the root cause: improper indentation of content between list items, not just numbering inconsistencies.
Install from the marketplace in Claude Code:
# Add the marketplace
/plugin marketplace add https://github.com/s2005/markdown-linter-fixer-skill
# Install the plugin
/plugin install markdown-linter-fixer@markdown-linter-fixer-marketplace
Or use the interactive plugin menu:
# Open the plugin management interface
/plugin
# Select "Browse Plugins" and install markdown-linter-fixer
For testing or development:
# Clone the repository
git clone https://github.com/s2005/markdown-linter-fixer-skill.git
# Add as a local marketplace
/plugin marketplace add ./markdown-linter-fixer-skill
# Install the plugin
/plugin install markdown-linter-fixer@markdown-linter-fixer-marketplace
The plugin manifest (.claude-plugin/plugin.json) and marketplace configuration (.claude-plugin/marketplace.json) configure the agent automatically.
Download the latest release or clone this repository
Package the skill:
cd skills/markdown-linter-fixer
zip -r ../../markdown-linter-fixer.zip SKILL.md references/
Upload to Claude:
For detailed installation and troubleshooting instructions, see INSTALLATION.md or the official guide at Using skills in Claude.
The skill requires markdownlint-cli2 to be installed. Claude will check for it and guide installation if needed:
# Global installation
npm install -g markdownlint-cli2
# Or local to project
npm install --save-dev markdownlint-cli2
Once installed, Claude automatically activates this skill when you:
Simple cleanup:
Fix all markdown linting errors in my project
Setup from scratch:
Set up markdown linting for my documentation
Specific MD029 issues:
I have ordered list numbering issues in my markdown files with code blocks
Comprehensive scan:
Scan all markdown files and create a report of issues
.
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace catalog
├── skills/ # Skills directory
│ └── markdown-linter-fixer/ # Skill directory
│ ├── SKILL.md # Main skill instructions
│ └── references/
│ └── MD029-Fix-Guide.md # Detailed MD029 indentation guide
├── examples/ # Example files
├── PLUGIN.md # Plugin documentation
├── README.md # This file
└── LICENSE # MIT License
Following Anthropic's recommendations, this skill uses progressive disclosure:
name + description) - Always loaded (~50 words)This keeps Claude's context window efficient while providing comprehensive guidance when required.
The included reference guide focuses on the root cause of MD029 errors:
<!-- markdownlint-disable MD029 -->.markdownlint.json filesUser: "Set up markdown linting for my documentation"
Claude: [Installs markdownlint-cli2, creates config, runs diagnostic, reports results]
User: "Fix all markdown linting errors"
Claude: [Scans, categorizes, auto-fixes, guides manual fixes, verifies completion]
User: "My lists with code blocks show MD029 errors"
Claude: [Scans for MD029, loads indentation guide, fixes with proper 4-space indentation]
The skill creates .markdownlint.json with sensible defaults:
{
"MD013": false
}
This disables the max line length rule while keeping other formatting checks active.
# Clone the repository
git clone https://github.com/s2005/markdown-linter-fixer-skill.git
cd markdown-linter-fixer-skill
# The plugin is ready to use - skill is at skills/markdown-linter-fixer/
# For manual installation, package just the skill:
cd skills/markdown-linter-fixer
zip -r ../../markdown-linter-fixer.zip SKILL.md references/
Contributions are welcome! Please:
Skill Type: Workflow-based with progressive disclosure
Dependencies: markdownlint-cli2 (npm package)
Supported Environments: GitBash, WSL2, Linux, macOS
File Format: Markdown with YAML frontmatter
Reference Files: 1 (MD029-Fix-Guide.md)
This skill:
Always review the skill contents before installing, especially:
MIT License - See LICENSE file for details.
Created following Anthropic's Agent Skills design pattern.
Special thanks to:
Version: 1.3.1 Last Updated: October 18, 2025 Compatibility: Claude Code, Claude Sonnet 4 and higher with code execution enabled
1.3.3