Markdown Strikethrough: Syntax for GitHub, Slack, Discord, Notion, Jira and More
Strikethrough in Markdown is ~~text~~ on GitHub, Reddit, Discord and Notion, but ~text~ in Slack and -text- in Jira. Syntax, the spacing gotcha, HTML fallbacks and a platform table.
Strikethrough is one of the few formatting options that is not in the original Markdown spec, so the right syntax depends on where you are typing. The short answer is two tildes on each side:
~~This text is crossed out.~~
This text is crossed out.
That works on GitHub, GitLab, Reddit, Discord, Notion, Obsidian, VS Code preview and most other places. The exceptions are the reason people end up searching for this, so the table below comes first.
Strikethrough syntax by platform
| Platform | Syntax | Notes |
|---|---|---|
| GitHub (README, issues, comments) | ~~text~~ |
GitHub Flavored Markdown also accepts ~text~ |
| GitLab | ~~text~~ |
|
~~text~~ |
New and old Reddit | |
| Discord | ~~text~~ |
|
| Slack | ~text~ |
One tilde. Slack does not use standard Markdown |
| Notion | ~~text~~ |
Typed shortcut, or select text and press Cmd/Ctrl + Shift + S |
| Obsidian | ~~text~~ |
|
| Jira and Confluence wiki markup | -text- |
Hyphens, not tildes |
| Pandoc | ~~text~~ |
Enabled by default for Markdown input via the strikeout extension |
| CommonMark (strict) | none | Not part of the core spec |
| HTML | <s>text</s> or <del>text</del> |
<strike> is deprecated |
If you are writing in one place and publishing in another, converting is easier than remembering. The Markdown to Slack formatter turns ~~text~~ into ~text~, and the Markdown to Jira converter turns it into -text-.
The spacing rule that breaks most attempts
The opening ~~ must touch the first character, and the closing ~~ must touch the last. A space inside the tildes means the parser treats them as literal characters:
~~ This will not strike. ~~
~~This will strike.~~
The same rule applies to bold and italics. If strikethrough does nothing, look for a stray space or a line break inside the markers first.
Strikethrough across multiple lines and paragraphs
Strikethrough does not span paragraphs. If you want to cross out a whole block, wrap each paragraph separately:
~~First paragraph that was removed.~~
~~Second paragraph that was removed.~~
For lists, put the markers inside the item, after the bullet:
- ~~Ship the beta~~
- Write the docs
Do not use strikethrough in place of a task list. If the goal is "done" items, a real checkbox (- [x] Ship the beta) is understood by GitHub, GitLab and Obsidian and keeps the state machine readable. The Markdown checklist generator builds them.
Combining with other formatting
Strikethrough nests with bold and italics in either order:
~~**Old price: $20**~~ New price: $15
Inside a table cell it works too, which is handy for changelogs and pricing comparisons:
| Plan | Price |
|---|---|
| Pro | ~~$20~~ $15 |
If a pipe character appears inside the struck text, escape it as \|.
When your renderer does not support it
If you see literal tildes in the output, the renderer is following the strict CommonMark spec or an older Markdown library. Three options:
- Enable the extension. In
marked, GFM is on by default. Inmarkdown-it, strikethrough is on in the default preset. In Python-Markdown, add thepymdownx.tildeextension from PyMdown Extensions. In Pandoc it is already on formarkdownandgfminput. - Use HTML. Most renderers that allow inline HTML will render
<del>old</del>or<s>old</s>. If the renderer sanitizes HTML, test before relying on it. - Use a Unicode combining character, such as writing t̶h̶i̶s̶. It works anywhere that accepts plain text, but it is hard to edit, hurts screen readers and breaks search, so use it only for places like social bios.
Accessibility note
Screen readers often do not announce strikethrough, so a reader may hear the removed text as if it were still valid. For anything important, such as a price change or a corrected fact, add a word as well: "$20 now $15" reads better than relying on the line alone.
Preview before you publish
Different platforms disagree, so check the result before pasting it somewhere you cannot easily edit. The Markdown live preview editor renders GFM, and the Markdown linter flags common spacing mistakes. If you are going further with text styling, see the guides on bold text, italics and underline. For the full list of syntax, use the Markdown cheat sheet.