# Markdown Formatting

> Use this skill whenever creating or editing any markdown file. Do not wait for an explicit request — if a markdown file is being created or edited, this skill applies.

- Skill: `naykel76/markdown-formatting-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add naykel76/markdown-formatting-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/naykel76/markdown-formatting-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: naykel76 (https://skillmd.com/u/naykel76)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/naykel76/markdown-formatting-2

---


## General

- No table of contents unless specifically requested.

## Code Blocks

All code blocks must include a language tag and a Torchlight flag.

| Flag           | Description                           |
| -------------- | ------------------------------------- |
| `+code`        | Source code only (syntax highlighted) |
| `+demo`        | Preview + code (always visible)       |
| `+demo-folded` | Preview + code + collapsible          |

Other flags (`+preview`, `+collapse`, `output`) exist but are less common — only use when requested.

### Language Tags

| Use For                         | Tag                     |
| ------------------------------- | ----------------------- |
| Directory trees, shell commands | ` ```bash +code `       |
| Blade templates                 | ` ```html +code-blade ` |

### Demo-Folded Attributes

When using `+demo-folded`, apply demo attributes intentionally:

- `class="..."` — outer demo wrapper styling
- `preview-class="..."` — preview-only layout or styling

Example opening tag:

```markdown
```html +demo-folded class="bx" preview-class="grid gap lg:cols-3"
<div class="example">Content here</div>
```

## Horizontal Rules

Use 80 hyphens as a visual section separator in long documents when a `---` thematic break is not appropriate:

`--------------------------------------------------------------------------------`

## Lists

- Use hyphens `-` for unordered lists
- Use `1.` `2.` for ordered steps
- 4-space indentation for nested items

## Tables

Standard GitHub Flavored Markdown. Keep column separators aligned.

| Column | Type         | Nullable | Default |
| ------ | ------------ | -------- | ------- |
| id     | bigint       | No       | AUTO    |
| name   | varchar(255) | No       | -       |

## Linting

- Blank line before and after headings, code blocks, and lists
- No trailing spaces
- Single blank line between sections — not double