# Md Linter

> Lint Markdown files for style issues, broken links, and formatting problems with auto-fix suggestions.

- Skill: `johnalbertini14-glitch/md-linter` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/md-linter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/md-linter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/johnalbertini14-glitch/md-linter

---


# Markdown Linter

Check and improve Markdown file quality.

## Capabilities

- **Style Checks**: Heading levels, list consistency, line length
- **Link Validation**: Check for broken internal/external links
- **Structure Analysis**: TOC generation, heading hierarchy
- **Auto-Fix**: Suggest or apply formatting corrections

## Usage

Ask the agent to:
- "Lint README.md for issues"
- "Check all markdown files in this directory"
- "Fix formatting issues in docs/"
- "Generate a table of contents for this document"

## How It Works

Analyzes Markdown files for common issues:
- Inconsistent heading levels (skipping levels)
- Trailing whitespace, missing blank lines
- Broken relative links
- Inconsistent list markers
- Long lines

Can use `markdownlint-cli` if available, or perform analysis with built-in text processing.

## Requirements

- Optional: `markdownlint-cli` (`npm install -g markdownlint-cli`)
- Works without external tools using text analysis
- No API keys needed