From linting
Check and fix formatting and other issues in markdown files using markdownlint-cli2
How this skill is triggered — by the user, by Claude, or both
Slash command
/linting:lint-markdownThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Check markdown files for common mistakes.
Check markdown files for common mistakes.
Search for a package.json in the current working directory and each ancestor directory up to and including the repository root.
If an ancestor package.json has markdownlint-cli2 in devDependencies, run npm install from that package.json directory to install it, then run npx markdownlint-cli2 <command> from the current working directory.
If no ancestor package.json contains markdownlint-cli2 in devDependencies, run npx -y markdownlint-cli2 <command> from the current working directory instead. Do not add markdownlint-cli2 to any package.json or install it permanently.
markdownlint-cli2 configuration including custom rules can be found in files:
.markdownlint-cli2.json.markdownlint-cli2.yaml.markdownlint-cli2.ymlIf a suitable configuration is not found, create a .markdownlint-cli2.yaml file in the root of the repository.
The configuration file schema is described at https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v<version>/schema/markdownlint-cli2-config-schema.json where <version> should match the markdownlint-cli2 version from the ancestor package.json devDependencies (e.g., v0.20.0). If no ancestor package.json contains markdownlint-cli2 in devDependencies, use https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/main/schema/markdownlint-cli2-config-schema.json.
Always include the schema URI in the $schema field.
For markdownlint rules configuration, nest it under the config property following the markdownlint schema at https://raw.githubusercontent.com/DavidAnson/markdownlint/main/schema/markdownlint-config-schema.json.
If not already present, add a globs array with file patterns to lint (e.g., ["**/*.md"]) so no command-line arguments are needed.
Run npx markdownlint-cli2 to lint Markdown files according to the configuration.
Run with the --fix flag to automatically fix supported issues:
npx markdownlint-cli2 --fix
Run the same lint command again to verify all issues are fixed. There should be no errors reported.
npx claudepluginhub heaths/plugins --plugin lintingRuns markdown linting validation on files or all project Markdown using markdownlint-cli2, auto-fixes issues, explains rules, and guides configuration. Ideal for clean docs.
Integrates markdownlint into workflows for linting Markdown files using CLI commands, Node.js programmatic API, CI/CD pipelines, pre-commit hooks, and editor plugins.
Formats markdown (.md) and MDX (.mdx) files using @takazudo/mdx-formatter. Supports Japanese text, Docusaurus admonitions, GFM, and HTML-to-md conversion.