Comprehensive markdown linting guidance using markdownlint-cli2. Run, execute, check, and validate markdown files. Fix linting errors (MD0XX rules). Configure .markdownlint-cli2.jsonc (rules and ignores). Set up VS Code extension and GitHub Actions workflows. Supports markdown flavors including GitHub Flavored Markdown (GFM) and CommonMark. Use when working with markdown files, encountering validation errors, configuring markdownlint, setting up linting workflows, troubleshooting linting issues, establishing markdown quality standards, or configuring flavor-specific rules for tables, task lists, and strikethrough.
View on GitHubmelodic-software/claude-code-plugins
code-quality
January 21, 2026
Select agents to install to:
npx add-skill https://github.com/melodic-software/claude-code-plugins/blob/main/plugins/code-quality/skills/markdown-linting/SKILL.md -a claude-code --skill markdown-lintingInstallation paths:
.claude/skills/markdown-linting/# Markdown Linting This skill provides comprehensive guidance for markdown linting using `markdownlint-cli2`, the industry-standard markdown linter that can be used in any project. ## Table of Contents - [Overview](#overview) - [When to Use This Skill](#when-to-use-this-skill) - [Markdown Flavors](#markdown-flavors) - [First Use: Installation and Setup](#first-use-installation-and-setup) - [Setting Up Markdown Linting in Your Repo](#setting-up-markdown-linting-in-your-repo) - [Quick Start](#quick-start) - [Unified Tooling Architecture](#unified-tooling-architecture) - [CRITICAL: Configuration Policy](#critical-configuration-policy) - [CRITICAL: NO AUTOMATED SCRIPTS](#critical-no-automated-scripts) - [Running Linting Locally](#running-linting-locally) - [Intelligent Fix Handling](#intelligent-fix-handling) - [VS Code Extension Setup (Optional/Advanced)](#vs-code-extension-setup-optionaladvanced) - [GitHub Actions Integration (Optional/Advanced)](#github-actions-integration-optionaladvanced) - [Customizing Rules (Requires Approval)](#customizing-rules-requires-approval) - [Troubleshooting](#troubleshooting) - [Best Practices](#best-practices) - [Resources](#resources) - [Evaluation Scenarios](#evaluation-scenarios) - [Multi-Model Testing Notes](#multi-model-testing-notes) - [Version History](#version-history) - [Last Updated](#last-updated) ## Overview This tooling enables enforcement of strict markdown quality standards through automated linting. Markdown files can be validated using `markdownlint-cli2` with a unified tooling approach that ensures zero configuration drift across VS Code, CLI, and CI/CD environments. **Core Philosophy:** - Single source of truth: `.markdownlint-cli2.jsonc` contains all configuration (rules, ignores, options) - Unified tooling: Same `markdownlint-cli2` engine everywhere (VS Code, CLI, CI/CD) - Strict enforcement: Fix content to comply with rules, not rules to accommodate content - Quality-first: Linting rules are intentional and