markdown-style

Enforce consistent Markdown styling across documents and AGENTS.md files.

19|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/nevir/agentfill --skill markdown-style
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-style
Source: https://github.com/nevir/agentfill/tree/main/.agents/skills/markdown-style
Command: npx skills add https://github.com/nevir/agentfill --skill markdown-style

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Markdown is often written inconsistently across documents, making reading and collaboration harder. This Skill enforces formatting and structure conventions to improve readability and maintainability.

Core Features & Use Cases

  • Enforces one H1 per file and proper heading nesting to preserve document hierarchy.
  • Standardizes lists, spacing, trailing whitespace, and line endings to improve readability.
  • References practical guidelines for tables, diagrams, and templates via included references.

Quick Start

Run the Markdown style guide on your repository to normalize all .md files.

Frequently Asked Questions about markdown-style

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

FAQPage Schema
How do I enforce consistent markdown formatting across documentation files?

Consistent markdown formatting is enforced by applying style conventions for headings, lists, spacing, trailing whitespace, and line endings to all .md files. This standardizes document hierarchy and readability across projects.

What is the best way to normalize heading hierarchy and lists in AGENTS.md files?

To normalize AGENTS.md files, enforce one H1 per file and proper heading nesting. This preserves document structure and standardizes lists for improved collaboration.

How does a markdown style guide handle tables, diagrams, and templates?

A markdown style guide handles tables, diagrams, and templates by referencing practical guidelines included in its references component. This ensures standardized formatting for complex elements in knowledge bases.

Can I use a markdown style guide to review and edit existing documentation projects?

Yes, you can use a markdown style guide to review and edit existing documentation projects. It applies formatting and structure conventions to normalize spacing, links, images, and trailing whitespace.

Why does inconsistent markdown spacing make collaboration harder?

Inconsistent markdown spacing makes collaboration harder because varying trailing whitespace, line endings, and list formats reduce readability. Enforcing style conventions normalizes these elements for maintainable documents.