Mastodon Post Formatter

Free forever, no sign-up, no watermark

Format your Mastodon toots with clean spacing and well-organized content for the Fediverse.

Formatting Options

Your formatted text will appear here...

Tips for Mastodon Post Formatting

  • Mastodon toots have a 500 character limit (varies by instance).
  • Standard Mastodon has no bold or italic formatting.
  • Use content warnings (CW) for sensitive topics.
  • Clean formatting improves readability across instances.
  • Hashtags help with discoverability on the Fediverse.

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

  1. Paste your toot into the Your Text box.
  2. 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.
  3. Leave Preserve Line Breaks off, as it starts, since Mastodon keeps line breaks on its own.
  4. Put each hashtag, or a group of them, on its own line and switch on Separate Hashtags to collect them at the bottom.
  5. Review the Formatted for Mastodon panel.
  6. 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.

Frequently asked questions

How many characters can a Mastodon post have?

The standard limit is 500 characters. Server admins can raise it, so some servers allow longer posts. The counter in your own composer shows the limit for your server.

Do links count toward the Mastodon limit?

Yes, but every link counts as 23 characters no matter how long it is. Mentions of people on other servers count only the username, not the server name. The counter on this page counts them the same way.

Does Mastodon support HTML or Markdown formatting?

Standard Mastodon posts are plain text with line breaks, links, mentions and hashtags. Some apps and modified servers render extra formatting, but most readers will see Markdown symbols as typed. Line breaks and paragraphs are the reliable way to structure a toot.

Should I use content warnings?

Use them for sensitive topics and spoilers, especially if your server or community expects it. The warning shares the post's character budget on standard Mastodon, so keep it short.

Where should hashtags go in a toot?

Either inside a sentence or in a row at the end. Many people prefer the end so sentences read naturally. Separate Hashtags collects lines made up only of hashtags and puts them in one row at the bottom.

Is Mastodon the same as the fediverse?

Mastodon is the best-known part of the fediverse, the wider network of independent servers and software that talk to each other. For posts that will be read on other fediverse software too, see the fediverse post formatter.

Does the formatter post to my Mastodon account?

No. It runs in your browser, does not connect to any server, and does not store your text. You copy the result and post it yourself.

The same tool for other networks