lint-markdown

Lint and fix Markdown files using markdownlint-cli2.

Updated Feb 8, 2026

Search Tags:#linting #best practices #documentation #markdown #formatting #markdownlint

Ready to run

npx skills add https://github.com/bresends/skills --skill lint-markdown-bresends

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: lint-markdown
Source: https://github.com/bresends/skills/tree/main/skills/lint-markdown
Command: npx skills add https://github.com/bresends/skills --skill lint-markdown-bresends

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures your Markdown files adhere to consistent formatting and best practices, catching and fixing common errors automatically.

Core Features & Use Cases

Automated Linting: Checks Markdown files against a comprehensive set of rules using markdownlint-cli2.
Auto-Fixing: Automatically resolves many common formatting issues like whitespace, list styles, and blank lines.
Manual Fix Guidance: Provides clear instructions and references for resolving issues that cannot be auto-fixed.
Use Case: When you need to ensure all documentation in a project is consistently formatted and easy to read, or when preparing Markdown files for publication.

Quick Start

Use the lint-markdown skill to fix formatting issues in the file 'README.md'.

Frequently Asked Questions about lint-markdown

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

FAQPage Schema

How do I lint and fix formatting errors in Markdown documentation?▼

To lint and fix Markdown formatting errors, this skill applies predefined or custom rule sets via markdownlint-cli2 to automatically resolve issues like whitespace, list styles, and blank lines in your files.

What are Markdown best practices for standardizing README files?▼

Markdown best practices for README files involve enforcing consistent formatting, standardizing syntax, and applying rule sets to catch common errors, ensuring all project documentation remains easy to read and uniformly structured.

Can I automatically fix Markdown linting issues that cannot be auto-corrected?▼

You cannot automatically fix all Markdown linting issues, but for those that cannot be auto-corrected, the skill provides clear manual fix guidance and references to help you resolve the formatting errors yourself.

Does this Markdown formatting tool support custom rule sets?▼

Yes, this Markdown formatting tool supports custom rule sets, allowing you to parse and correct Markdown syntax according to either predefined best practices or your own specific configuration requirements.

Do I need markdownlint-cli2 to enforce Markdown formatting standards?▼

Yes, you need markdownlint-cli2 installed because the skill requires it to parse Markdown files and automatically correct syntax and formatting errors according to your chosen rule sets.