skills.rest
lc0rp
lc0rpCOMMUNITY
Explore all skills by this author →
Website𝕏@lukekyohereGitHub

markdown-cleanup

Detect and fix MD036 and MD052 Markdownlint-cli2 errors in Markdown documents.

Updated Aug 23, 2026
Search Tags:#documentation#markdown#lint#markdownlint#reference-links#emphasis#markdown-cleanup
One-click install
npx skills add https://github.com/lc0rp/luke-agent-scripts --skill markdown-cleanup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-cleanup
Source: https://github.com/lc0rp/luke-agent-scripts/tree/main/parked-skills/markdow-cleanup
Command: npx skills add https://github.com/lc0rp/luke-agent-scripts --skill markdown-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fixes common Markdownlint-cli2 errors that cannot be autofixed, specifically MD036 (emphasis as heading) and MD052 (reference links).

Core Features & Use Cases

  • Detects MD036 and MD052 style issues in Markdown documents.
  • Proposes safe, human-readable edits to correct emphasis usage and properly spaced/defined reference links.
  • Useful for documentation sites, README files, and notes where consistent formatting matters.

Quick Start

Run markdown-cleanup on your Markdown files to automatically identify and propose fixes for MD036 and MD052 issues.

Frequently Asked Questions about markdown-cleanup

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

FAQPage Schema
How do I fix Markdownlint errors that can't be autofixed?▼

Markdownlint errors like MD036 and MD052 can be fixed by identifying emphasis used as headings and reformatting reference links so they comply with Markdownlint rules without introducing new formatting issues.

What is the MD036 emphasis as heading lint error?▼

The MD036 lint error occurs when emphasis is used as a heading in Markdown documents, which can be corrected by converting the emphasis to proper Markdown heading syntax for consistent formatting.

How do I correct misformatted reference links in Markdown?▼

Reference links causing MD052 lint errors are corrected by ensuring they are properly spaced and defined, producing safe, human-readable edits that comply with Markdownlint rules.

Can I use markdown-cleanup on README files and documentation?▼

Yes, it detects and proposes fixes for MD036 and MD052 issues in README files, documentation sites, and notes where consistent Markdown formatting matters.

What's the best way to fix MD052 reference link issues?▼

The best way to fix MD052 reference link issues is to apply edits that ensure links are properly spaced and defined, complying with Markdownlint rules without creating new formatting problems.

Related Skills

Explore More Content & Communication Skills→
bresendsbresends

lint-markdown

Lint and fix Markdown files using markdownlint-cli2.

Community
Intermediate
hdickohdicko

markdown-to-html

Convert Markdown documents into HTML for web pages and static sites.

Community
Intermediate
voidreadervoidreader

docs-writer

Review and edit markdown documentation to match repository-specific conventions.

Community
Advanced
NetcrackerNetcracker
5

markdown

Audit Markdown files for markdownlint violations and fix them in-place.

Official
Intermediate