hackmd-notelisted
Install: claude install-skill unbias38/my-claude-skills
# HackMD Note Writer
Write information-rich HackMD notes that make full use of HackMD's extended Markdown syntax.
## Before Writing
Read [references/syntax-core.md](references/syntax-core.md) for the core HackMD syntax.
Read [references/syntax-advanced.md](references/syntax-advanced.md) ONLY when the note needs
diagrams (mermaid/graphviz/sequence/flow/markmap/vega), music notation, a slide deck, or book mode.
## Writing Guidelines
1. **Use the right feature for the job.** Pick syntax that enhances readability:
- `:::info` / `:::warning` / `:::danger` / `:::success` for callouts
- `:::spoiler` for supplementary details the reader can expand
- `> [!TIP]` / `> [!NOTE]` / `> [!IMPORTANT]` for inline alerts
- `==highlight==` for key terms, `++underline++` for emphasis
- Tables for structured comparisons
- `[TOC]` when the note has 4+ sections
- Mermaid / flow / sequence / graphviz diagrams when visualizing processes or relationships
- MathJax when formulas appear
- `{%youtube ID %}` / `{%pdf URL %}` / `{%figma URL %}` for embeds
2. **Structure clearly.** Use headings (`##`–`####`), horizontal rules (`---`), and tags (`` ###### tags: `tag` ``). Lead with a brief summary or context block.
3. **Keep it scannable.** Combine prose paragraphs with bullet lists, tables, and diagrams. Avoid walls of text.
4. **Respect the output mode.** If the user asks for a slide deck, use `---` / `----` separators and `slideOptions` YAML. If they ask for a book, use `