Mastodon supports basic text formatting to make your posts more readable and engaging. Unlike some other social platforms, Mastodon does not rely on a visual editor for rich formatting. Instead, it uses Markdown, a lightweight markup language that converts plain text into styled HTML. This article explains which Markdown elements work in Mastodon posts and how to apply them correctly. You will learn the exact syntax for bold, italic, lists, links, and other formatting options available on most Mastodon instances.
Key Takeaways: Markdown Syntax for Mastodon Posts
- Asterisks for bold and italic: Use double asterisks text for bold and single asterisks text for italic.
- Square brackets for links: Write [display text](URL) to create clickable hyperlinks.
- Numbered lists with periods: Start each line with 1. 2. 3. and a space to create ordered lists.
Markdown Support Overview in Mastodon
Mastodon processes post content through an HTML sanitizer that strips out unsafe tags. The platform supports a subset of standard Markdown syntax. This subset includes bold, italic, strikethrough, inline code, blockquotes, unordered lists, ordered lists, and links. Headers, horizontal rules, images, and tables are not allowed in Mastodon posts for security and consistency reasons.
Markdown formatting is applied at the server level when you submit a post. The Mastodon web interface and most third-party clients render the formatted text correctly. Some clients may display raw Markdown syntax if they do not support rendering. To ensure wide compatibility, stick to the supported elements listed in this article.
Prerequisites for Using Markdown
You need a Mastodon account on any instance. No special settings are required to enable Markdown. The feature is built into the posting system. You can use Markdown in the web interface, mobile apps, and third-party clients that support the Mastodon API.
Steps to Apply Markdown Formatting in Mastodon Posts
Follow these steps to format your Mastodon posts using Markdown syntax. Each step shows the exact characters you need to type. Mastodon does not provide a preview of formatted text before posting. Check your post after publishing to confirm the formatting works.
- Type bold text
Enclose the word or phrase with two asterisks on each side. Example:important announcement. This renders as important announcement. - Type italic text
Enclose the word or phrase with one asterisk on each side. Example:subtle emphasis. This renders as subtle emphasis. - Type a link
Use square brackets for the display text followed by parentheses for the URL. Example:[Mastodon Guide](https://joinmastodon.org). This creates a clickable link. - Type a strikethrough
Enclose the text with two tilde characters on each side. Example:~~outdated information~~. This renders asoutdated information. - Type inline code
Enclose the code snippet with a single backtick on each side. Example:`sudo apt update`. This renders assudo apt update. - Type a blockquote
Start the line with a greater-than sign followed by a space. Example:> This is a quote.. This renders as an indented blockquote. - Type an unordered list
Start each line with a hyphen followed by a space. Example:- item oneon a new line. Mastodon renders this as a bulleted list. - Type an ordered list
Start each line with a number, a period, and a space. Example:1. first stepon a new line. Mastodon renders this as a numbered list.
Common Mistakes and Limitations
Even with correct syntax, some Markdown elements may not render as expected. The following issues occur frequently.
Headers and Horizontal Rules Do Not Render
Typing # Header or --- has no effect in Mastodon posts. The platform strips these elements for security. Use bold text instead of headers to emphasize a section.
Images Are Not Supported
The Markdown image syntax  does not work in Mastodon posts. To share an image, use the media attachment button in the post composer. Mastodon attaches the image as a file, not as inline Markdown.
Tables Are Stripped
Markdown table syntax using pipes and dashes is not supported. Mastodon removes table markup entirely. For structured data, use a numbered list or a bulleted list instead.
Nested Formatting May Break
Combining bold and italic inside a list item or link can produce unexpected results. Example: text may render as bold italic in some clients but as plain text in others. Test nested formatting before publishing.
Mastodon Markdown vs Plain Text Posting
| Item | Markdown Posting | Plain Text Posting |
|---|---|---|
| Bold text | Use double asterisks | Not available |
| Italic text | Use single asterisks | Not available |
| Clickable links | Use [text](URL) syntax | Paste raw URL |
| Lists | Use – or 1. at line start | Not available |
| Character limit | 500 characters (Markdown syntax counts) | 500 characters |
Markdown posts require more keystrokes but produce cleaner, more readable content. Plain text posts are simpler but lack visual hierarchy. Choose Markdown when you need to emphasize key points or include multiple links.
You can now format Mastodon posts using bold, italic, links, lists, blockquotes, inline code, and strikethrough. Start by applying bold to your next announcement and links to cited sources. For advanced formatting, consider using a third-party Mastodon client that offers a rich text editor, but be aware that the underlying Markdown syntax remains the same.