Skip to content
All posts
7 min read
markdown
reddit
formatting
guide
social

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:

FeatureRedditGitHub GFM
Bold**text**✅ same
Italic*text* or _text_✅
Strikethrough~~text~~✅
Tablespipe 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):

  1. No spaces between markers and text — >! spoiler !< fails; >!spoiler!< works.
  2. Inline only — cannot span multiple lines in one marker.
  3. 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)
PatternExampleResult
Single word^wordsuperscript word
Parenthesized phrase^(multiple words)entire phrase superscripted
Per-word^each ^wordeach word separately

Gotchas:

  • ^(parenthesized syntax) may misparse on Old Reddit — prefer single-word ^word for 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.

[Markdown Viewer](https://trymarkdownviewer.com)

Links can contain spaces in the URL on Reddit (unusual vs. other platforms).

Check [the docs][1] for details.

[1]: https://trymarkdownviewer.com/docs
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:

  1. Rich Text editor — upload image directly.
  2. Post URL — link to Imgur / GitHub image in prose.
  3. Subreddit rules — some require specific hosts.

Do not expect ![alt](url) 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

FeatureWorkaround
Task lists - [ ]Use bullet lists or plain text
Footnotes [^1]Use ^superscript or endnotes section
GFM alerts > [!NOTE]Use bold + quote
Mermaid diagramsPost PNG link or describe in prose
HTML tagsStripped — use Markdown only
Emoji :shortcode:Copy-paste Unicode emoji instead

New Reddit vs. Old Reddit

AspectNew RedditOld Reddit
Table rendering✅✅
Spoilers✅⚠️ CSS-dependent
^(superscript)✅⚠️ may misparse
Markdown mode✅✅ default
PreviewBuilt-inBuilt-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:

  1. Write and preview GFM content.
  2. Add Reddit-specific spoilers (>!…!<) and superscript (^…).
  3. Verify tables have separator rows.
  4. 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 syntaxReddit action
**bold**Keep
![img](url)Replace with Rich Text upload or link
- [ ] tasksConvert to bullets
[^footnote]Rewrite as superscript or section
```mermaidReplace with description or PNG
GFM alertsConvert to > quote or bold

Run through HTML to Markdown if copying from rendered HTML instead of source.

Quick reference

SyntaxPurpose
**bold** *italic* ***both*** ~~strike~~Emphasis
>!spoiler text!<Spoiler (no spaces inside markers)
^word ^(phrase)Superscript
# H1 ## H2 ### H3Headings
- bullet / 1. numberedLists
> quoteBlockquote
`code` / triple-backtick fenceCode
Pipe table + |---| rowTables
[text](url) r/sub u/userLinks

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.