markdown-lists

Enforce Markdown list formatting rules for nested items and indentation.

3|5|Updated Mar 19, 2026

Search Tags:#documentation #markdown #formatting #lists #nesting #bullets

Ready to run

npx skills add https://github.com/ronniegeraghty/hyoka --skill markdown-lists

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: markdown-lists
Source: https://github.com/ronniegeraghty/hyoka/tree/main/skills/test/markdown-lists
Command: npx skills add https://github.com/ronniegeraghty/hyoka --skill markdown-lists

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides authoritative rules for formatting Markdown lists to ensure consistent presentation across documents and reduce editing time.

Core Features & Use Cases

Clear rules for bullet lists and numbered lists, including marker choice, spacing, blank lines around lists, and nested-item indentation.
Applies to any Markdown file (e.g., README, docs, technical specs) that includes lists to ensure first-pass correctness.
Use Case: when writing or editing documentation, READMEs, or technical notes that rely on clear list formatting.

Quick Start

Apply these rules to every markdown list you write to ensure clean, consistent formatting on the first pass.

Frequently Asked Questions about markdown-lists

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

FAQPage Schema

How do I format nested markdown lists consistently?▼

Consistent markdown list formatting requires 2-space indentation for nested items, blank lines before and after lists, and standardized bullet markers or numbering to ensure clean rendering across documents.

What are the standard rules for markdown bullet and numbered list spacing?▼

Standard markdown list spacing requires blank lines before and after lists to separate them from paragraphs, consistent marker choices for bullets, and correct 2-space indentation for any nested items.

Does this markdown list formatting apply to README and technical documentation files?▼

Yes, this markdown list formatting applies to any .md file, including README files, technical specs, and documentation, ensuring first-pass correctness for simple bullets, nested items, and multi-level lists.

Why do my markdown nested lists render incorrectly in documentation?▼

Nested markdown lists render incorrectly when indentation is not exactly 2 spaces per level or when blank lines are missing before and after the list block, breaking the document's formatting consistency.

What is the best way to standardize bullet markers in markdown files?▼

The best way to standardize bullet markers in markdown is to apply consistent formatting rules that enforce a single marker style, correct 2-space nesting indentation, and proper blank line spacing around all lists.