The Mastodon post formatter cleans up a toot before you publish it on your Mastodon server. Paste your draft and the tool trims stray spaces from each line, collapses double spaces, reduces long gaps to a single blank line, and can collect your hashtag lines into one tidy row at the end. You get a clean version next to your draft, ready to copy into Mastodon's composer or your favorite app.
Mastodon gives you more room than most short-form networks, 500 characters on a standard server, and its culture rewards posts that are considerate to read: clear paragraphs, hashtags people can follow, content warnings where they help, and image descriptions. This guide explains what the formatter changes, how Mastodon counts your text, and the habits that make a toot feel at home.
What makes a well-formatted Mastodon post
Mastodon shows posts as plain text with line breaks, links, mentions, hashtags and custom emoji. Standard Mastodon has no bold, italic or headings in the composer, so structure comes from paragraphs and blank lines. Because there is no algorithmic feed reshuffling your posts, people read them in their home timeline in order, often scrolling quickly. A toot with a clear first line and short paragraphs holds attention in that stream.
Hashtags carry more weight here than on many networks. People follow hashtags directly, and for a long time hashtags were the main way to search Mastodon at all. Search across post text is still something people choose to opt in to. A neat row of well-chosen tags at the end of a toot helps the right readers find it without cluttering the sentences above.
How the Mastodon post formatter works
All of the work happens in your browser. The tool does not log in to your server or post on your behalf. You choose which of five cleanups to apply, and the formatted panel updates as you type.
It also does some cleanup you never have to switch on. Invisible characters such as zero-width spaces, word joiners and byte order marks are stripped, Windows line endings are turned into plain line breaks, and non-breaking spaces and similar odd spaces from word processors become regular spaces. Because old spacers are removed first, a post that was already formatted does not end up with two invisible characters after each line break.
Trim Lines
Deletes spaces at the start and end of each line, so pasted text does not arrive with uneven indents or hidden trailing spaces.
Fix Double Spaces
Turns any run of spaces into a single space.
Clean Extra Whitespace
Shrinks three or more line breaks to two, which keeps exactly one blank line between paragraphs.
Preserve Line Breaks
Inserts an invisible zero-width space after each line break for apps that drop empty lines. Mastodon keeps your line breaks as typed, and every invisible character counts toward your limit, so the tool starts with it switched off for Mastodon.
Separate Hashtags
Moves every line made up only of hashtags into a single row at the end, after a blank line. This is a common Mastodon layout: the message first, the tags underneath.
How to use the Mastodon post formatter
- Paste your toot into the Your Text box.
- Check the counter against the 500 character limit. It counts the formatted post with each link as 23 characters, the way Mastodon does. If your server allows longer posts, you can ignore the red warning.
- Leave Preserve Line Breaks off, as it starts, since Mastodon keeps line breaks on its own.
- Put each hashtag, or a group of them, on its own line and switch on Separate Hashtags to collect them at the bottom.
- Review the Formatted for Mastodon panel.
- Copy the text into your Mastodon composer, add a content warning if the topic needs one, and write an image description for any media before you post.
How Mastodon counts characters
The standard Mastodon software allows 500 characters per post. Server admins can change that, so some servers allow longer posts. The number in your composer is the one that applies to you.
Mastodon counts two things in a special way. Every link counts as 23 characters, however long the address really is. And a mention of someone on another server counts only the username part, not the server name after it. The counter on this page applies both rules to the formatted post, so a long link counts as 23 here too. If the counter says you are a little over, check your composer before you cut anything, since your server may allow more than 500.
A content warning is written in its own field but, on standard Mastodon, it shares the same character budget as the post. A long warning leaves less room for the toot itself.
Use cases on Mastodon
Introduction posts
Many people pin an introduction toot when they join a server. A few short lines about who you are and what you post, followed by a row of hashtags such as interests and a general introductions tag, is easy to read and easy to find.
Project and release updates
Open source and creative projects often announce on Mastodon. Short paragraphs, a link on its own line and topic tags at the end make an update scannable.
Threads of toots
When a topic needs more than one post, format each toot as a complete unit with its own clear opening. Consistent spacing across the thread makes it feel like one piece.
Posts with content warnings
With a content warning, readers see the warning first and choose to expand the post. Clean formatting matters even more once they do, since they have opted in to read it.
Cross-posting from another network
Text copied from elsewhere often carries extra spacing, platform-specific formatting and many hashtags squeezed into sentences. Clean it here, move the tags to the end, and adjust the tone for Mastodon.
Best practices for Mastodon toots
Write hashtags in CamelCase
Capitalize each word in a multi-word tag, such as #BookClub rather than #bookclub. Screen readers can then read the words separately, and the tag still matches the same posts.
Use content warnings with care
Many servers and communities expect a content warning for topics like politics, violence or spoilers. Keep the warning short and descriptive so people can decide quickly.
Describe your images
Alt text is an everyday expectation on Mastodon, and some people choose not to boost posts without it. Add a description to every image before you publish.
Keep tags relevant
Hashtags are followed by real people, so a tag that does not fit the post is noise in their timeline. A few precise tags beat a long list.
Respect your server's rules
Each Mastodon server sets its own rules. Formatting does not change what is allowed, so check them, especially for promotional posts.
Mistakes to avoid
Forgetting your own server limit
The counter here uses 500, the standard Mastodon limit, and counts links and remote mentions the way Mastodon does. Your server may allow more, so when the counter turns red, Mastodon's composer is the final check.
Leaving invisible characters in
Zero-width spaces from Preserve Line Breaks are not needed on Mastodon and quietly use up characters. Leave the option off, as it starts for Mastodon.
Relying on rich formatting
Standard Mastodon shows Markdown symbols and Unicode lookalike letters as they are. Asterisks will appear as asterisks, and styled Unicode letters are hard for screen readers. Use plain text and paragraphs.
Adding words to a tag line
Separate Hashtags only moves lines made entirely of hashtags, so a line that starts with something like #1 stays put. A tag line with a word of text on it stays put too, so keep tag lines to tags only.
Fitting Mastodon into your publishing routine
If you post to Mastodon as part of a wider schedule, FoPost can publish to your Mastodon account along with your other networks, so the version you format and check is the version that goes out at the time you choose. For a single toot, this page plus your composer is all it takes.