dansnow Markdown to Runbook Conversion
Convert markdown documentation to Atuin Runbook (.atrb) YAML format with interactive terminal blocks.
Quick Start
uv run ~/.claude/skills/md-to-runbook/scripts/md_to_atrb.py <input.md> [output.atrb]
What Gets Converted
| Markdown | ATRB Node | Notes |
|---|---|---|
# Heading |
heading |
Levels 1-6 supported |
| Paragraphs | paragraph |
|
- [ ] item |
checkListItem |
Unchecked checkbox |
- [x] item |
checkListItem |
Checked checkbox |
- item |
bulletListItem |
|
1. item |
numberedListItem |
|
```bash (commands) |
run |
Interactive terminal |
```text (output) |
codeBlock |
Display only |
| Tables | table |
Full cell formatting |
> quote |
quote |
|
**bold** |
styles: {bold: true} |
|
`code` |
styles: {code: true} |
Executable vs Display Code Blocks
Bash blocks with actual commands become interactive run nodes:
- Commands:
pnpm,npm,yarn,npx - Scripts:
./scripts/...,doppler run - Shell ops:
cat,cd,pwd,ls,for...done - Env vars:
CONVEX_URL=...,ENCRYPTION_KEY=...
Example output or non-bash code stays as display-only codeBlock.
Options
# Specify output path
uv run md_to_atrb.py input.md output.atrb
# Override runbook name (default: first heading or filename)
uv run md_to_atrb.py input.md --name "My Runbook"
Schema Reference
See references/atrb-schema.md for full ATRB node type documentation.