skills.rest
s2005
s2005COMMUNITY
Explore all skills by this author →
GitHub

markdown-linter-fixer

Diagnose and fix markdown linting issues in Markdown files.

10|1|Updated Oct 17, 2025
Search Tags:#automation#documentation#markdown#code-quality#lint#md029#markdownlint-cli2
One-click install
npx skills add https://github.com/s2005/markdown-linter-fixer-skill --skill markdown-linter-fixer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-linter-fixer
Source: https://github.com/s2005/markdown-linter-fixer-skill/tree/main/skills/markdown-linter-fixer
Command: npx skills add https://github.com/s2005/markdown-linter-fixer-skill --skill markdown-linter-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the detection and automatic fixing of markdown linting issues across projects, reducing manual effort and ensuring consistent documentation quality.

Core Features & Use Cases

  • Automated diagnosis: Scans Markdown files recursively to identify lint errors.
  • Auto-fixes where possible: Applies safe fixes for common issues (e.g., MD029 indentation) without altering content meaning.
  • Comprehensive reports: Generates before/after summaries and per-file results for audits and CI.

Quick Start

To start, install and invoke the skill to scan your repository for Markdown linting issues, then choose automatic fixes or a report-only run as needed.

Frequently Asked Questions about markdown-linter-fixer

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

FAQPage Schema
How do I automatically fix markdown linting errors in my documentation?▼

Markdown linting fixes scan your .md files recursively, auto-correct solvable issues like MD029 indentation problems, and generate reports of changes made. This Skill verifies markdownlint-cli2 installation, applies safe fixes, and guides manual corrections where needed.

What markdown linting issues can be fixed automatically?▼

Auto-fixes handle safe, content-preserving corrections such as MD029 indentation violations. The Skill identifies all lint errors through markdownlint-cli2, auto-corrects what it safely can, and provides guidance for issues requiring manual intervention.

Can I integrate markdown linting checks into my documentation workflow?▼

Yes. This Skill runs recursive scans across your project's markdown files, generates before-and-after reports, and produces comprehensive audit summaries suitable for CI pipelines and documentation quality assurance.

Do I need markdownlint-cli2 installed to use this automation?▼

The Skill includes a verification step that checks for markdownlint-cli2 installation and guides setup if needed, making it accessible whether you have it pre-installed or need to configure it first.

What output does the markdown linting process generate?▼

The workflow produces comprehensive reports showing per-file results, issues fixed, remaining lint violations, and actionable guidance for manual fixes, enabling documentation audits and CI integration.

Related Skills

Explore More Content & Communication Skills→
PovertyActionPovertyAction
3

markdownlint

Lint and auto-fix Markdown files for consistent style and syntax.

Official
Intermediate
tneztnez

fix-markdown-lint

Fix Markdown linting errors in documentation files using markdownlint-cli2.

Community
Intermediate
dhar174dhar174
1

markdown-to-html

Converts Markdown documents to HTML for web display or static sites.

Community
Intermediate
devs6186devs6186

plankton-code-quality

Run formatters and linters on file edits across multiple languages.

Community
Advanced