skills.rest
cardoso-neto
cardoso-netoCOMMUNITY
Explore all skills by this author →
GitHub

markdown

Enforce consistent Markdown formatting with ATX headings and markdownlint.

3|1|Updated Dec 4, 2025
Search Tags:#linting#documentation#markdown#consistency#markdownlint#style-guide#atx
One-click install
npx skills add https://github.com/cardoso-neto/personal-ai-infra --skill markdown-cardoso-neto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown
Source: https://github.com/cardoso-neto/personal-ai-infra/tree/main/skills/markdown
Command: npx skills add https://github.com/cardoso-neto/personal-ai-infra --skill markdown-cardoso-neto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill establishes a consistent, readable standard for authoring and editing Markdown documents, reducing confusion and rework.

Core Features & Use Cases

  • Enforces ATX headings and clean formatting.
  • Guides nesting of supplementary details and concise main points.
  • Use in documentation, READMEs, and notes to maintain uniform style and quality.

Quick Start

Create a new Markdown file that adheres to the style rules outlined above.

Frequently Asked Questions about markdown

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

FAQPage Schema
How do I enforce consistent Markdown formatting and style across my documentation?▼

You can enforce consistent Markdown formatting by applying ATX headings, structured lists, and linting via markdownlint to auto-fix issues across documentation, READMEs, and notes.

What is the best way to auto-fix Markdown linting issues in my README files?▼

The best way to auto-fix Markdown linting issues is using markdownlint, which enforces clean formatting, proper ATX headings, and concise content to maintain uniform style and quality.

Can I use this markdown style guide for drafting notes and technical documentation?▼

Yes, you can use this markdown style guide for drafting and editing notes, technical documentation, and READMEs to ensure well-structured content and reduce rework.

How does ATX heading formatting improve Markdown document consistency?▼

ATX heading formatting improves Markdown consistency by enforcing a standardized heading structure, which guides the nesting of supplementary details and ensures clean, readable documents.

Why do my Markdown files have inconsistent list structures and nested details?▼

Markdown files have inconsistent list structures when lacking a style guide, which this skill resolves by guiding nested detail formatting and enforcing structured lists via markdownlint auto-fixing.

Do I need any dependencies to maintain a consistent Markdown style guide?▼

No dependencies are required to maintain a consistent Markdown style guide, as the skill operates standalone to enforce formatting rules and auto-fix issues using markdownlint.

Related Skills

Explore More Content & Communication Skills→
bahayonghangbahayonghang
3

kb-compile

Compile markdown captures into draft knowledge with summaries and indices.

Community
Intermediate
fraguiofraguio

rendercv

Convert YAML CV content into PDF, HTML, Markdown, and PNG outputs.

Community
Advanced
KrystianYCSilvaKrystianYCSilva

markdown-expert

Create Markdown documentation with Mermaid diagrams and GFM tables.

Community
Intermediate
cdeistopenedcdeistopened
9

ai-tells

Detect and eliminate linguistic patterns that signal AI-generated text.

Community
Basic