markdown-lint

Configure markdownlint and pre-commit to enforce Markdown formatting standards.

11|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/niracler/skill --skill markdown-lint-niracler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-lint
Source: https://github.com/niracler/skill/tree/main/skills/workflow/markdown-lint
Command: npx skills add https://github.com/niracler/skill --skill markdown-lint-niracler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Configures and enforces markdown quality across a repository by setting up markdownlint rules, a pre-commit hook, and guidance on addressing common errors such as MD013, MD040, MD060 and horizontal rule violations.

Core Features & Use Cases

  • Repository-wide linting: Automatically checks and formats Markdown files with markdownlint-cli2.
  • Pre-commit integration: Installs and configures pre-commit so checks run before every commit.
  • Migration & onboarding: Helps teams adopt consistent Markdown standards across projects and repos.

Quick Start

Install and configure markdownlint and pre-commit in your repository, then run the lint checks on all Markdown files.

Frequently Asked Questions about markdown-lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up markdown linting with pre-commit checks in my repository?

To set up markdown linting with pre-commit, configure markdownlint-cli2 rules and wire the pre-commit framework into your repository workflow to enforce formatting standards before every commit.

What do the MD013, MD040, and MD060 markdownlint rules check for?

The MD013, MD040, and MD060 rules are common markdown formatting checks enforced by markdownlint to prevent line length issues, missing code block languages, and horizontal-rule violations across your files.

Can I use markdownlint-cli2 to enforce markdown formatting standards in existing projects?

Yes, markdownlint-cli2 can enforce markdown formatting standards in existing projects by checking all Markdown files against configured rules and preventing violations during local commits and CI runs.

How does a pre-commit hook prevent horizontal-rule violations in markdown files?

A pre-commit hook prevents horizontal-rule violations by running markdownlint checks before the commit is finalized, automatically blocking any markdown files that fail the formatting rules from being submitted.

What's the best way to automate markdown quality checks across a repository in CI?

The best way to automate markdown quality checks in CI is configuring markdownlint-cli2 with pre-commit, ensuring consistent formatting standards run automatically on all Markdown files during CI runs and local commits.