What tools does this skill require?

It utilizes the markdownlint CLI tool, which can be installed globally or as a dev dependency via npm or pnpm.

Does it support custom configurations?

Yes, it automatically detects and respects existing .markdownlint.json, .yaml, .markdownlintrc, or package.json configurations.

Which specific markdown rules does it follow?

It follows the comprehensive markdownlint rule set, covering everything from heading levels (MD001) to code block language requirements (MD040).

Can it handle MDX files?

Yes, the skill is specifically designed to work with both standard Markdown (.md) and MDX (.mdx) files commonly used in modern web frameworks.

Can it fix errors automatically?

Yes, the skill can execute the --fix command to automatically resolve common formatting and syntax issues without manual intervention.

Markdown & MDX Linter

Name: Markdown & MDX Linter
Author: denolfe

bydenolfe

•

Developer Tools

Formats and lints Markdown and MDX files using markdownlint to ensure documentation consistency and standard compliance.

The Markdown Formatting skill empowers Claude to automatically maintain high-quality documentation by identifying and fixing structural issues in .md and .mdx files. By leveraging the markdownlint CLI, it ensures consistent heading levels, proper list formatting, valid link structures, and clean whitespace. This skill is particularly useful for developers managing project READMEs, technical documentation, or content-heavy sites who want to automate style guide enforcement and prevent common formatting errors.

Key Features

01Automated linting and fixing for Markdown (.md) and MDX (.mdx) files

02Validation of links, images, and alt-text for correctness

03Auto-detection of project-specific markdownlint configurations

04Standardized heading hierarchy and structure enforcement

05Seamless integration with npm/pnpm scripts for workflow automation

0680 GitHub stars

Use Cases

01Standardizing project READMEs and documentation across a repository

02Cleaning up legacy markdown files with inconsistent whitespace or list markers

03Integrating automated documentation linting into a project's development workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add denolfe/dotfiles markdown-formatting

For use in Claude.ai and ChatGPT

Download Skill