markdown
Installation
SKILL.md
Markdown
Formatting and structure conventions for Markdown files. Based on CommonMark spec, GitHub Flavored Markdown (GFM) extensions, Google Markdown style guide, and markdownlint defaults.
1. Consistency choices
These are arbitrary but must be consistent within a file and across a project:
| Element | Convention | Rationale |
|---|---|---|
| Headings | ATX (#) |
Consistent, easy to grep |
| Unordered lists | Hyphens (-) |
Avoids * ambiguity with emphasis |
| Ordered lists | Lazy numbering (1. for all) |
Diffs stay clean on reorder |
| Emphasis | Asterisks (*italic*, **bold**) |
More common than underscores |
| Code fences | Backticks (```) |
Standard, not tildes |
| Horizontal rules | --- |
Three hyphens, nothing else |
| Link style | Inline for short/one-off, reference for long/repeated | Balance readability and maintainability |
2. Headings
Related skills