skills.rest
frankhjung
frankhjungCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

markdown-validator

Validate markdown files against standards for headings, lists, links, and grammar.

Updated Dec 6, 2025
Search Tags:#linting#documentation#markdown#validation#formatting#content standards
One-click install
npx skills add https://github.com/frankhjung/cli-tools --skill markdown-validator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-validator
Source: https://github.com/frankhjung/cli-tools/tree/main/files/gemini/skills/markdown-validator
Command: npx skills add https://github.com/frankhjung/cli-tools --skill markdown-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces consistent markdown formatting and content standards, preventing errors and improving readability across documentation.

Core Features & Use Cases

  • Content Rule Enforcement: Validates headings, lists, code blocks, links, images, tables, line length, whitespace, and spelling/grammar.
  • Formatting Guidelines: Ensures adherence to specific markdown syntax for structure and presentation.
  • Use Case: Automatically check all .md files in a project to ensure they meet the team's documentation standards before merging.

Quick Start

Use the markdown-validator skill to check the formatting of the file 'README.md'.

Frequently Asked Questions about markdown-validator

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

FAQPage Schema
How do I validate markdown formatting across documentation files?▼

Markdown validation prevents formatting errors by enforcing specific syntax for headings, lists, links, and tables, ensuring readability and structural consistency across all project documentation before merging.

Can I enforce spelling and grammar standards in markdown documentation?▼

Yes, this skill enforces spelling and grammar standards by validating text using Australian English and code using US English, ensuring linguistic consistency across markdown documentation.

What is the line length limit for markdown content validation?▼

The markdown line length limit is strictly 400 characters. This constraint ensures consistent formatting and prevents overly long lines that hinder readability in documentation files.

Does markdown validation work with tables and code blocks?▼

Yes, markdown validation checks tables and code blocks against predefined standards to ensure correct syntax, proper structure, and consistent presentation across documentation.

What is the best way to check markdown files before merging a project?▼

The best way to check markdown files before merging is to use an automated validation skill that lints headings, lists, links, and whitespace, ensuring all content meets team documentation standards.

Why does markdown validation fail on inconsistent whitespace?▼

Markdown validation fails on inconsistent whitespace because this skill enforces strict formatting guidelines. Proper whitespace usage ensures structural integrity and predictable rendering of lists, code blocks, and tables.

Related Skills

Explore More Content & Communication Skills→
aztr0nutzsaztr0nutzs
2

text-processor

Clean and format raw text by stripping HTML and normalizing whitespace.

Community
Basic
chengyihuachengyihua

baoyu-markdown-to-html

Convert Markdown with frontmatter into styled HTML for WeChat articles.

Community
Advanced
jesuscottagejesuscottage

corregir-ortografia

Correct Spanish spelling and accent errors in markdown files.

Community
Intermediate
sandgardenhqsandgardenhq
130

create-opencode-agents

Create specialized OpenCode agents with custom prompts, models, tools, and permissions.

Official
Intermediate