discord-markdown
Installation
SKILL.md
Discord Markdown
Discord renders a small subset of Markdown and renders it literally: every blank line becomes visible vertical space, and unsupported syntax shows up as raw characters. Write for that renderer from the start rather than writing standard Markdown and hoping.
Rules 1 to 5, and the file:// case of rule 6, are transformations that the bundled converter (scripts/converter.js, a copy of this repo's js/converter.js) performs mechanically. Rule 8 is a guarantee the converter makes. The rest are authoring rules. The checker in scripts/check.js covers both groups; see the final section.
Supported syntax
| Element | Write |
|---|---|
| Headings | # , ## , ### only (three levels), starting at column 1 |
| Subtext (small grey line) | -# text |
| Bold / italic / underline / strike | **b**, *i*, __u__, ~~s~~ |
| Spoiler | ||hidden|| |
| Inline code / code block | `code`, fenced ```lang block (backticks only; ~~~ is not a fence in Discord) |
| Quote | > line (single) or >>> (rest of message) |
| Bullet list | - item or * item (+ is not a marker); nest with exactly two leading spaces |
| Numbered list | 1. item (1) is not a marker) |
| Link | [text](https://url); wrap as <https://url> to suppress the embed card |