Buttondown Documentation
Buttondown has a built-in WYSIWYG editor (in addition to the markdown editor) that allows you to view and edit your emails in a way that resembles how they will be formatted when they are sent.
Fancy mode comes with a variety of different built-in components. To view the different options, use the toolbar at the top of the editor or type "/" on a new line.
You can either upload your own image or use a stock photo from Unsplash.
Buttondown has a built-in Unsplash integration, allowing you to search & embed high-quality images without leaving the app.
To search for images on Unsplash, click Find image on Unsplash using the slash menu and a modal will pop up. Search for the image that you want and click on it for it to be added to your email.
To upload an image, you can drag and drop the image into the editor, or type /image on a new line to attach the image file.
See a more detailed guide here.
Emojis are fully supported in the editor.
Not sure which emoji to use? Simply type a colon (":") followed by a word describing the emoji (e.g., "happy") to see some suggestions.
Shortcut: You can add a block quote by typing > followed by a space.
Text inside a pull quote is italicized and centered, as opposed to a block quote.
Use a poetry block if you want the text to maintain its spacing when it is published.
Code blocks are automatically syntax highlighted based on the programming language.
Shortcut: type 3 backticks followed by the programming language and press enter (for example: ```python).
Adding a footnote will add 2 things in the editor:
Note: when you delete a footnote reference, the corresponding footnote will also be deleted.
Shortcut: add a footnote by typing [^text], "text" being any string sequence.
A LaTeX block allows you to write & render LaTeX content inside the editor. (Note that as of now, LaTeX is only renderable as a "block", and not inline with text.)
Shortcut: add a LaTeX block by typing your expression inside two dollar signs ($$) and pressing space/enter.
A divider is a horizontal line that sits between 2 pieces of content.
Shortcut: add a divider by typing 3 dashes or underscores & pressing space/enter.
A webwall enables you to add content that will only be displayed on the web. Any content below the webwall will not be included in the email sent to email clients.
Add a subscription form to allow your readers to easily subscribe to your newsletter from within the email.
Subscription forms are only displayed on the web.
A subscription button is a CTA button that links to your newsletter's URL, allowing people to subscribe to your newsletter there.
Search and link to another email by typing two opening square brackets ("[["), this will open up a list of your emails.
In Fancy Mode, you also have a variety of text formatting options. This includes things like:
To access text formatting, you'll select the text you'd like to format, and a tooltip will pop-up with the available options.
The available email-safe font options are: