skills.rest
CodeTonight-SA
CodeTonight-SAOFFICIAL
Explore all skills by this author →
WebsiteGitHub

markdown-expert

Lint Markdown files for structural errors and code block language tags.

Updated Aug 23, 2026
Search Tags:#linting#documentation#technical writing#formatting#Markdown#AI quality#code blocks
One-click install
npx skills add https://github.com/CodeTonight-SA/claude-optim --skill markdown-expert
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-expert
Source: https://github.com/CodeTonight-SA/claude-optim/tree/main/skills/markdown-expert
Command: npx skills add https://github.com/CodeTonight-SA/claude-optim --skill markdown-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI models frequently generate Markdown with systematic errors (e.g., missing language tags, bold text as headings, incorrect spacing), leading to inconsistent, hard-to-read documentation and wasted tokens on rework. This skill enforces strict Markdown linting standards.

Core Features & Use Cases

  • Automated Linting Enforcement: Ensures all generated Markdown adheres to best practices (e.g., MD040, MD036, MD022, MD013).
  • Code Block Language Tags: Mandates language specifiers for all code blocks (e.g., bash, typescript, text).
  • Structural Correctness: Prevents common errors like using bold/italics for headings and enforces proper blank lines around structures.
  • Use Case: You need to generate a README.md or update project documentation, and you want to ensure it's perfectly formatted and lint-free.

Quick Start

"Write a new README.md for my project, ensuring perfect Markdown linting." "Review this Markdown file for any linting violations and fix them."