markdown - SKILL.md Agent Skill

name: markdown description: Markdown style guide. Use when writing or editing markdown files to ensure consistent formatting with Setext headings, hyphen bullets, and plain-text readability.

Markdown Style

Format for plain-text readability. Style preferences only; assumes Markdown knowledge.

Headings

Use Setext-style for level 1 and 2 headings:

Document Title
==============

Section Heading
---------------

Use ATX-style for level 3 and deeper:

### Subsection

#### Sub-subsection

Lists

Use a hyphen ("-") for bullet list markers.

Emphasis

Bold with asterisks (e.g., **bold**). Italicize with underscores (e.g., _italic_).

Code

All instances of code or shell session examples should go into fenced code blocks.

console.log('Hello world!');

git diff

Always include an info string with a fenced code block and use long form names over abbreviations.

<!-- Good -->
```typescript
console.log('Hello, world!');
```

<!-- Bad (no info string) -->
```
console.log('Hello, world!');
```

<!-- Bad (abbreviated info string) -->
```ts
console.log('Hello, world!');
```

Spacing

One blank line between block elements (e.g., headings, paragraphs, block quotations, lists, headings, rules, code blocks, etc.).
No trailing whitespace.
Single newline at end of file.