Reddit Markdown: Complete Formatting Guide for Posts & Comments (2026)
Master Reddit snoomark formatting — bold, spoilers, superscript, tables, code blocks, old vs new Reddit quirks, and how to preview before you post.
Reddit processes hundreds of millions of posts with a custom Markdown dialect called snoomark — built on GitHub Flavored Markdown but with its own extensions (spoilers, superscript) and its own gaps (no images in Markdown mode, no task lists, no footnotes).
Get the syntax wrong and your carefully formatted guide becomes a wall of asterisks and broken tables. Get it right and your post reads clean on both New Reddit and Old Reddit.
This guide is the complete Reddit formatting reference: every supported element, Reddit-only syntax, platform quirks, and preview workflows before you hit submit.
Reddit snoomark vs. standard Markdown
Reddit's processor is GFM-based with additions and omissions:
| Feature | GitHub GFM | |
|---|---|---|
| Bold | **text** | ✅ same |
| Italic | *text* or _text_ | ✅ |
| Strikethrough | ~~text~~ | ✅ |
| Tables | pipe tables | ✅ |
| Fenced code | ``` | ✅ |
| Syntax highlight | ❌ | ✅ |
| Task lists | ❌ | ✅ |
| Footnotes | ❌ | ✅ |
| Images (Markdown) | ❌ | ✅ |
| Spoilers | >!text!< | ❌ |
| Superscript | ^text | ❌ |
| Emoji shortcodes | ❌ | ✅ |
Switch to Markdown mode: in the post/comment composer, choose Markdown Mode (not Rich Text) to type snoomark directly.
Bold, italic, and combined
**bold text**
*italic text*
***bold italic***
___bold italic___
~~strikethrough~~
Reddit accepts both * and _ for emphasis — unlike Slack, **double asterisks** works for bold on Reddit.
Spoilers — Reddit-only syntax
Hide text behind a click-to-reveal overlay:
The ending was >!actually the butler!< all along.
Rules (from Reddit's official formatting guide):
- No spaces between markers and text —
>! spoiler !<fails;>!spoiler!<works. - Inline only — cannot span multiple lines in one marker.
- Subreddit CSS — some old communities may not style spoilers; test if unsure.
Compare with Discord's ||spoiler|| — see the Discord guide. Cross-posting between platforms requires rewriting spoiler syntax.
Superscript — Reddit-only syntax
E=mc^2
Water is H^(2)O
Multi-word: ^(see appendix)
| Pattern | Example | Result |
|---|---|---|
| Single word | ^word | superscript word |
| Parenthesized phrase | ^(multiple words) | entire phrase superscripted |
| Per-word | ^each ^word | each word separately |
Gotchas:
^(parenthesized syntax)may misparse on Old Reddit — prefer single-word^wordfor compatibility.- Superscript with links needs careful spacing — apply
^to link text, use quarter-width spaces (U+2005) between words if layout breaks. - Do not nest superscript levels — unsupported.
Reddit users employ superscript for footnote-style asides because GFM footnotes do not render. For GitHub-bound content, use real footnotes instead.
Headings
# Heading 1
## Heading 2
### Heading 3
Headings work in self-posts and long comments. In short comments, bold lines often scan better than # headers.
Do not skip levels for accessibility — go H1 → H2 → H3 in order when structuring long guides.
Lists
Bulleted
- Item one
- Item two
- Nested item (indent two spaces)
Plus signs (+) do not work on Reddit — use - or *.
Numbered
1. First step
2. Second step
3. Third step
Must start at 1. — arbitrary starting numbers may not render as expected. You can use 1) instead of 1. as ending punctuation.
Block quotes
> Single line quote
> Multi-line quote
> continues here
Nested quotes with >> work for reply-style formatting in AMAs and discussion threads.
Code — inline and fenced
Inline:
Use `printf()` for debugging.
Fenced blocks:
```
function hello() {
console.log("reddit");
}
```
No syntax highlighting on Reddit — language tags after the opening fence are ignored. Keep code short; huge blocks hurt mobile readers.
For long code, link to a GitHub gist or repo file instead.
Tables
GFM pipe tables work — separator row required:
| Language | Score |
| -------- | ----- |
| Rust | 9.5 |
| Go | 8.7 |
Without | --- | between header and body, the table does not render. Build tables in the table generator, then paste.
Wide tables scroll on mobile — keep columns ≤ 4 when possible.
Links
Inline links
[Markdown Viewer](https://trymarkdownviewer.com)
Links can contain spaces in the URL on Reddit (unusual vs. other platforms).
Reference-style links
Check [the docs][1] for details.
[1]: https://trymarkdownviewer.com/docs
Subreddit and user links
r/markdown
u/spez
Auto-link to communities and profiles — Reddit-specific shorthand, not standard Markdown.
Bare URLs
https://trymarkdownviewer.com
Auto-linked without brackets.
Images — the major limitation
Markdown mode does not embed images from URLs in most comment contexts. Options:
- Rich Text editor — upload image directly.
- Post URL — link to Imgur / GitHub image in prose.
- Subreddit rules — some require specific hosts.
Do not expect  to work in Markdown mode — plan for Rich Text or external links.
Horizontal rules
---
Three dashes on their own line — separates sections in long guides.
What Reddit does not support
| Feature | Workaround |
|---|---|
Task lists - [ ] | Use bullet lists or plain text |
Footnotes [^1] | Use ^superscript or endnotes section |
GFM alerts > [!NOTE] | Use bold + quote |
| Mermaid diagrams | Post PNG link or describe in prose |
| HTML tags | Stripped — use Markdown only |
Emoji :shortcode: | Copy-paste Unicode emoji instead |
New Reddit vs. Old Reddit
| Aspect | New Reddit | Old Reddit |
|---|---|---|
| Table rendering | ✅ | ✅ |
| Spoilers | ✅ | ⚠️ CSS-dependent |
^(superscript) | ✅ | ⚠️ may misparse |
| Markdown mode | ✅ | ✅ default |
| Preview | Built-in | Built-in |
For maximum compatibility, avoid edge-case superscript and test spoilers in the target subreddit.
Formatting patterns that perform well
Explainer post structure
# How I migrated 200 wiki pages to Markdown
**TL;DR:** Pandoc + custom script + two weekends.
## The problem
...
## What worked
1. ...
2. ...
## What failed
>!Spoiler: Confluence macros!< were the hardest part.
## Tools
| Tool | Role |
| ---- | ---- |
| [HTML to Markdown](https://trymarkdownviewer.com/tools/html-to-markdown) | Cleanup |
Comment with spoiler
Great film. Cinematography >!especially the final scene!< was stunning.
Technical answer
Run this:
```
curl -X POST https://api.example.com/render \
-H "Authorization: Bearer TOKEN" \
-d '{"markdown":"# Hi"}'
```
Returns HTML in the `html` field.
Preview before posting
Reddit's composer has a Preview tab — use it. For longer posts, draft in the Markdown editor first:
- Write and preview GFM content.
- Add Reddit-specific spoilers (
>!…!<) and superscript (^…). - Verify tables have separator rows.
- Copy into Reddit Markdown mode.
Editor differences: the browser editor uses GitHub bold rules (same as Reddit) but renders spoilers as plain text — expected.
Cross-posting from GitHub README
README content often needs edits for Reddit:
| README syntax | Reddit action |
|---|---|
**bold** | Keep |
 | Replace with Rich Text upload or link |
- [ ] tasks | Convert to bullets |
[^footnote] | Rewrite as superscript or section |
```mermaid | Replace with description or PNG |
| GFM alerts | Convert to > quote or bold |
Run through HTML to Markdown if copying from rendered HTML instead of source.
Related articles
- CommonMark vs GFM — what Reddit inherits
- Discord Markdown guide — different spoiler syntax
- Slack Markdown guide — workplace alternative
- Markdown table guide — pipe table details
- Markdown cheat sheet — full syntax reference
Quick reference
| Syntax | Purpose |
|---|---|
**bold** *italic* ***both*** ~~strike~~ | Emphasis |
>!spoiler text!< | Spoiler (no spaces inside markers) |
^word ^(phrase) | Superscript |
# H1 ## H2 ### H3 | Headings |
- bullet / 1. numbered | Lists |
> quote | Blockquote |
`code` / triple-backtick fence | Code |
Pipe table + |---| row | Tables |
[text](url) r/sub u/user | Links |
Reddit rewards clarity over clever formatting. Master spoilers, superscript, tables, and fenced code — that is the full Reddit-specific toolkit on top of standard GFM.
Written by Markdown Viewer Team. Found this useful? Try the editor →
Keep reading
Hand-picked articles related to this one.
Master Markdown in Microsoft Teams — chat compose formatting, the differences from GitHub GFM, Adaptive Card markdown, and incoming-webhook message formatting for bots and CI.
Every WhatsApp formatting trick — bold, italic, strikethrough, monospace, bulleted and numbered lists, block quotes, and inline code — plus what breaks when you paste from elsewhere.
Complete Telegram formatting guide — MarkdownV2 vs legacy Markdown vs HTML parse modes, the full escaping rules, spoilers, custom emoji, and in-app shortcuts that actually work.