Reddit Markdown Formatting Guide
Reddit markdown explained — bold, italic, code, superscript, spoilers, and tables, plus the differences between old Reddit, new Reddit, and the rich-text editor.
Short answer: Reddit markdown is close to standard markdown with two additions of its own: superscript with ^text and spoilers with >!spoiler!<. You get **bold**, *italic*, ~~strikethrough~~, `code`, > quotes, [text](url) links, # headers, lists, --- rules, and tables. There is no HTML, no inline image syntax, and no task-list checkboxes.
The catch is that Reddit has two editors and two renderers. The rich-text editor hides markdown from you entirely; the markdown editor hands it back. Old Reddit and new Reddit don't support quite the same feature set. Get the combination wrong and your carefully formatted comment posts as a paragraph of punctuation. Here's the full syntax and where each piece works.
The Two Editors
When you write a post or comment on modern Reddit, you're in a rich-text editor by default — often called the "fancy pants" editor. It has a toolbar, and typing **bold** in it converts to bold as you type. You never see markdown.
There's a toggle in the composer that switches to a plain markdown text box, where your syntax stays visible until you submit. The exact control has moved around between Reddit redesigns — it's usually a small button labeled for markdown or shown as a T-style icon near the toolbar — but it's always in the composer's edge, and recent clients remember your choice.
Which one you want:
- Rich-text editor — fine for short comments and anything where you'd use the toolbar anyway.
- Markdown editor — necessary when you're pasting formatted text from elsewhere, writing superscript or spoilers, building a table, or writing about markdown syntax itself.
old.reddit.com has no rich-text editor. Every box is a markdown box. If you're an old Reddit user, everything below is simply how Reddit works.
The Core Syntax
| Format | Syntax |
|---|---|
| Bold | **bold** or __bold__ |
| Italic | *italic* or _italic_ |
| Bold italic | ***text*** |
| Strikethrough | ~~text~~ |
| Superscript | ^text or ^(text with spaces) |
| Spoiler | >!hidden text!< |
| Inline code | `code` |
| Quote | > quoted text |
| Link | [text](https://example.com) |
| Header | # through ###### |
| Bullet list | * or - |
| Numbered list | 1. |
| Horizontal rule | --- or *** |
| Escape | \* |
Unlike Discord, Reddit follows the standard convention where __text__ is bold, not underline. Unlike Slack, it uses doubled delimiters. If you've learned markdown anywhere else, Reddit will feel familiar.
Superscript
^ is Reddit's own. It raises text:
E = mc^2
For more than one word, wrap the text in parentheses:
This is a normal sentence. ^(This is a small aside in superscript.)
Without the parentheses, the superscript stops at the first space. This is the source of a lot of accidentally half-raised sentences.
Superscript's real use on Reddit isn't math — it's the community convention for footnotes, disclaimers, bot signatures, and the small self-deprecating aside at the end of a comment. If you're writing actual mathematics, superscript won't get you far; a proper editor with LaTeX math support will, and you can post an image or link to the rendered version.
Because ^ is a formatting character, a literal caret needs escaping: \^.
Spoilers
Reddit's spoiler syntax is >! and !< around the hidden text:
The killer was >!the lighthouse keeper!<.
The text renders as a blacked-out block that reveals on click or tap. It works inline mid-sentence, and it works across a whole paragraph.
Two things to watch. First, spoilers are inline-only — you can't wrap a code block or a table in one. Second, on some clients a spoiler that spans a line break doesn't close properly, so keep each spoiler within a single paragraph. Many subreddits also have their own spoiler rules on top of the syntax; check the sidebar before you rely on the tag alone.
Code Blocks: The Old vs New Split
This is the most practical old/new Reddit difference.
Four-space indentation creates a code block and works everywhere, including old Reddit:
def hello():
print("hi")
Note that nested indentation inside the code stacks on top of the four spaces — that inner print line needs eight.
Fenced code blocks with triple backticks work in the new Reddit renderer:
```
def hello():
print("hi")
```
They do not render on old.reddit.com, where a fenced block shows up as literal backticks around your code. Since a meaningful share of Reddit's power users are still on old Reddit, four-space indentation remains the safe choice for anything you want everyone to read correctly. Neither form does syntax highlighting — Reddit code blocks are monospaced and plain.
Inline code with single backticks works everywhere and is unaffected by this split.
Tables
New Reddit supports pipe tables with the same shape as GitHub's, including alignment colons:
| Item | Cost | Notes |
|:-----|-----:|:-----:|
| Widget | 12.00 | in stock |
| Gadget | 4.50 | backordered |
The rules are the familiar ones: a header row, a separator row of hyphens with optional colons, and pipes between cells. Escape a literal pipe as \|.
Three Reddit-specific cautions. Tables are a new-Reddit feature — on old.reddit.com support is inconsistent, so don't rely on a table if your audience reads there. Tables also need to be written in the markdown editor — building one in the rich-text editor is awkward at best. And they compress badly on the mobile apps, where anything past three columns becomes a scrolling mess. Reddit comments are read on phones more than anywhere else, so keep tables narrow or don't use one.
Lists, Quotes, and Line Breaks
Lists work as expected:
* First
* Second
* Nested item
* Third
1. Step one
2. Step two
Nesting is by indentation. Four spaces is the reliable amount — two sometimes works on the newer renderer and fails on old Reddit.
Quotes use > with a space:
> This is the part I'm responding to.
And this is my response.
Now the line break problem, which generates more confused Reddit comments than any other rule. A single newline is not a line break. Press Enter once between two lines and Reddit joins them into one paragraph. To separate them, press Enter twice — a blank line between paragraphs.
This line and
this line become one paragraph.
This is a separate paragraph.
The rich-text editor papers over this by inserting real breaks for you, which is exactly why a comment that looked right while you typed it can post as a single block after you switch editors or paste it somewhere else. When in doubt, use blank lines.
What Reddit Does Not Support
- HTML. Completely stripped. No
<br>, no<sub>, no<details>, no styling of any kind. Anything you can't express in Reddit's markdown, you can't do. - Inline images via markdown.
does not render an image in a comment. Where a subreddit has enabled images in comments, they're added through the editor's upload control, not through syntax. In self-posts you can attach media; you cannot place it mid-paragraph with markdown. - Task list checkboxes.
- [ ]renders as literal brackets, not a checkbox. - Footnotes, definition lists, and math notation. None.
- Syntax highlighting in code blocks.
- Custom styling. Old Reddit let moderators ship a subreddit stylesheet, which is where flair art, custom tables, and hover-image jokes came from. New Reddit doesn't load those stylesheets — communities configure appearance through Reddit's own settings instead. If a subreddit's wiki tells you to use some clever CSS-dependent formatting trick, assume it only works on old.reddit.com.
Escaping and Common Accidents
Backslash escapes any formatting character. The ones you'll actually need:
\*not italic\*
\^not superscript
\#not a header
\[not a link\]
Three accidents happen constantly:
Accidental headers. A comment that starts with #hashtag becomes a giant H1. Escape it as \#hashtag, or put a space before the hash.
Accidental italics in filenames and identifiers. file_name_here can render as file + italic + here depending on the renderer. Wrap identifiers in backticks.
Runaway superscript. ^ with no closing parenthesis raises everything up to the next space, which reads as a typo rather than a style choice.
Reddit also autolinks bare URLs and turns r/subreddit and u/username into links automatically. You don't need markdown link syntax for those, and wrapping them in brackets usually looks worse.
Drafting Longer Reddit Posts
For a two-line comment, type it in the box. For a long-form post — a guide, a build log, an AMA answer set, a subreddit wiki page — the Reddit composer is a poor place to work. There's no local copy, no undo history worth the name, and a browser crash costs you the whole thing.
Writing in a markdown editor first solves all of that and gives you a rendered preview before you commit. OpenMark shows the source with syntax coloring in Markdown view and the rendered document in Document view, so you can check your structure, then paste the source into Reddit's markdown editor. Reddit's flavor is close enough to standard markdown that most of it transfers directly — you'll only need to add the ^superscript and >!spoiler!< pieces, since those are Reddit's alone.
Two adjustments before you paste: remove any HTML you were relying on, and swap fenced code blocks for four-space indentation if old Reddit readers matter to you. Everything else — bold, italic, headers, lists, quotes, links, tables — goes across unchanged.
If you're new to the underlying syntax, start with the markdown cheat sheet and keep it open in another window.
If you saved a draft as a .md file and need to open it, see how to open an .md file on Mac, iPhone and iPad.
Download OpenMark → — $9.99, one-time, native macOS. Draft long Reddit posts locally, preview them rendered, and keep the file when the thread scrolls away.