skills.rest
theafh
theafhCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

format_markdown

Format Markdown files to enforce linting compliance and style best practices.

38|7|Updated May 3, 2026
Search Tags:#linting#documentation#markdown#style guide#tables#code blocks
One-click install
npx skills add https://github.com/theafh/ai-modules --skill format-markdown-theafh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: format_markdown
Source: https://github.com/theafh/ai-modules/tree/main/plugins/ai_dev/skills/format_markdown
Command: npx skills add https://github.com/theafh/ai-modules --skill format-markdown-theafh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you avoid inconsistent Markdown formatting and common style issues that make documents harder to read, review, and maintain.

Core Features & Use Cases

  • Blank-line and spacing compliance: Enforces predictable spacing around headings, lists, tables, and fenced code blocks.
  • Code block and table correctness: Requires fenced code blocks to include language identifiers and applies consistent table alignment syntax.
  • Readable lists and link conventions: Standardizes bullet markers, nested indentation, and prevents bare URLs while encouraging descriptive link text.

Quick Start

Ask the AI to format your Markdown snippet so it follows format_markdown rules for spacing, lists, headings, links, and fenced code blocks.

Frequently Asked Questions about format_markdown

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

FAQPage Schema
How do I enforce consistent Markdown formatting for headings, lists, and tables?▼

To enforce consistent Markdown formatting, apply linting rules that standardize blank lines around headings, lists, and tables, ensuring predictable spacing and readable document structure across .md files.

Why do my Markdown code blocks fail linting checks?▼

Markdown code blocks fail linting when they lack language identifiers or consistent blank-line spacing. Enforce fenced code blocks with language tags and proper surrounding spacing to achieve linting compliance.

What is the best way to standardize bullet markers and indentation in Markdown?▼

The best way to standardize bullet markers and indentation in Markdown is to apply a style guide that enforces uniform bullet characters, consistent nested indentation, and required blank lines between list items.

Can I use this Markdown linter to fix bare URLs and link conventions in documentation?▼

Yes, you can fix bare URLs by enforcing safe link conventions that require descriptive link text. The linter standardizes link syntax to improve readability and maintainability in documentation files.

Does Markdown linting require a single trailing newline and valid table alignment?▼

Yes, Markdown linting requires a single trailing newline at the end of files and valid table alignment syntax. It also enforces rules to prevent skipping header levels for proper document structure.

Related Skills

Explore More Content & Communication Skills→
CloudyWingCloudyWing

check-markdown

Detects and corrects Markdown formatting and platform-specific admonitions in documentation files.

Community
Intermediate
BrunoAMSilvaBrunoAMSilva

markdown-to-html

Convert Markdown files to sanitized HTML with templates.

Community
Intermediate
dt418dt418

Docs Pack

Build documentation platforms with versioned docs, search, navigation, code highlighting, and API reference generation.

Community
Intermediate
Albatross679Albatross679

latex

Generate LaTeX documents for ACL conference papers and academic reports.

Community
Intermediate