Format and lint Markdown and MDX files against markdownlint rules.
npx skills add https://github.com/denolfe/dotfiles --skill markdown-formatting
Please help me install this Agent Skill. Skill: markdown-formatting Source: https://github.com/denolfe/dotfiles/tree/main/claude/skills/markdown-formatting Command: npx skills add https://github.com/denolfe/dotfiles --skill markdown-formatting
Markdown and MDX files in large docs repositories often suffer from inconsistent formatting, trailing spaces, and rule violations that stall reviews. This Skill automates formatting and linting to enforce best practices and reduce manual cleanup.
Install markdownlint if needed:
High-intent search queries and answers about installing and using this skill.
Markdown formatting can be automatically fixed using markdownlint with the --fix flag. Run `markdownlint --fix "**/*.{md,mdx}"` to apply consistent styles, fix trailing spaces, and correct rule violations across your docs repository in one pass.
Markdownlint enforces standard markdown rules including MD001 (heading levels), MD013 (line length), MD033 (inline HTML), and others to ensure consistent formatting. It detects violations and can auto-fix many common issues to improve readability and maintain documentation standards.
Yes, markdownlint supports both .md and .mdx files. Use `markdownlint "**/*.{md,mdx}"` to lint MDX alongside markdown, making it ideal for large documentation repositories that mix both formats.
Markdownlint recognizes common config file formats and works out of the box with default rules. Install via `pnpm add -D markdownlint` or `npm install -g markdownlint`, then run immediately. Custom rules can be configured if needed for team standards.
Automated markdown linting and auto-fix eliminates manual formatting cleanup during reviews. By enforcing consistent styles, fixing trailing spaces, and catching rule violations upfront, reviewers focus on content quality rather than formatting issues.
Linting detects and reports markdown violations without changing files. Auto-fix applies corrections automatically. Markdownlint supports both: use `markdownlint` to report issues or `markdownlint --fix` to resolve them automatically.
pantheon-orgAuthor lint-compliant Markdown documentation with deterministic structure and CI integration.
wtthorntonGenerate API documentation, READMEs, and docstrings in Markdown, reStructuredText, and HTML.
hw-native-sysAutomate Git commits with pre-commit hooks, testing, and linting.
gao-hongnanStandardize Markdown syntax and formatting across project documentation.
