Buttondown Markdown: Complete Guide
Buttondown is an email newsletter tool built for markdown. You write your newsletter content in markdown, and Buttondown converts it to a clean, styled HTML email. It supports GFM, metadata, subscriber management, and automation features.
Markdown support:Full
Markdown Support in Buttondown
| Format | Syntax | Support |
|---|---|---|
| Bold | **text** | Yes |
| Italic | *text* | Yes |
| Strikethrough | ~~text~~ | Yes |
| Headings | # H1 ... ###### H6 | Yes |
| Links | [text](url) | Yes |
| Images |  | Yes |
| Blockquotes | > quote | Yes |
| Ordered Lists | 1. item | Yes |
| Unordered Lists | - item | Yes |
| Code (inline) | `code` | Yes |
| Code Blocks | ```lang\ncode\n``` | Yes |
| Tables | | col | col | | Yes |
| Task Lists | - [ ] task | Yes |
| Footnotes | [^1] | Yes Rendered in the email output |
| Horizontal Rule | --- | Yes |
Things to know
- Designed specifically for email newsletters written in markdown.
- Supports metadata and front matter for newsletter configuration.
- Includes subscriber management, analytics, and paid subscriptions.
- Also offers a WYSIWYG editor for non-markdown users.
Frequently Asked Questions
Does Buttondown support markdown?
Yes. Buttondown is built for markdown-based newsletters. It supports full GFM including headings, bold, italic, links, images, code blocks, tables, footnotes, and task lists.
How do you bold text in Buttondown?
Use standard markdown syntax: **bold text**. Buttondown converts the markdown to styled HTML when the newsletter is sent to subscribers.
Is Buttondown free?
Buttondown offers a free tier for up to 100 subscribers. Paid plans unlock higher subscriber limits, automation, custom domains, and analytics.
Can Buttondown send HTML emails from markdown?
Yes. Buttondown converts your markdown content into clean, responsive HTML emails. The styling is customizable, and you can also embed raw HTML when needed.