O Mastodon não oferece suporte completo a Markdown em todos os lugares, mas muitas instâncias e aplicativos clientes oferecem formatação estilo Markdown para postagens e campos de perfil. Os usuários frequentemente tentam usar asteriscos ou sublinhados para texto em negrito e itálico, apenas para ver os caracteres brutos aparecerem em vez do conteúdo formatado. Isso acontece porque o Mastodon usa uma sintaxe diferente — um subconjunto de HTML ou marcação personalizada — dependendo da versão do software e das configurações da instância. Este artigo explica exatamente onde a formatação funciona, como aplicá-la e o que evitar.
Principais Conclusões: Formatação de Texto no Mastodon
- Tags HTML no conteúdo da postagem: Use
<b>,<i>,<a>e<span>para negrito, itálico, links e estilo inline onde a instância permite HTML. - Biografia e campos do perfil: Apenas texto simples — sem renderização de Markdown ou HTML na interface web.
- Aplicativos clientes com suporte a Markdown: Apps como Tusky e Fedilab interpretam sintaxe Markdown como negrito e itálico antes de publicar.
Como o Mastodon Lida com Formatação em Comparação com Markdown Verdadeiro
O Mastodon foi criado como uma plataforma de microblogging onde as postagens são curtas e o texto simples é o padrão. O software principal não inclui um interpretador Markdown para o conteúdo das postagens. Em vez disso, o Mastodon usa um processador de texto personalizado que remove a maioria das tags HTML por segurança — ele só permite uma pequena lista de elementos HTML seguros. Essa lista geralmente inclui <b>, <i>, <a>, <span> e <br>. O objetivo é evitar injeção de scripts e quebra de layout, ainda dando aos usuários controle básico sobre o texto.
Muitos aplicativos clientes de terceiros do Mastodon, no entanto, implementam seu próprio suporte a Markdown. Esses apps convertem a sintaxe Markdown em HTML antes de enviar a postagem para o servidor do Mastodon. O servidor então aplica sua lista de permissões HTML, o que significa que a saída formatada pode ser removida se o app usar tags que não estão na lista. Os campos de perfil — seu nome de exibição, biografia e metadados do perfil — são renderizados como texto simples na interface web oficial e na maioria dos clientes. Nenhuma formatação é aplicada lá.
Instâncias do Mastodon também podem habilitar o fork glitch-soc ou temas personalizados que adicionam renderização Markdown. Glitch-soc, um fork popular do Mastodon, inclui uma opção Markdown nas configurações do usuário. Quando ativada, as postagens são processadas com um interpretador Markdown antes de serem armazenadas. Isso não está disponível em servidores Mastodon padrão. Você deve verificar com o administrador da sua instância ou procurar por uma opção “Markdown” nas suas preferências.
Aplicando Formatação em Postagens do Mastodon
O método exato depende do software da sua instância e do cliente que você usa. Siga os passos para sua situação.
Método 1: Usando Tags HTML em uma Instância Mastodon Padrão
- Abra a interface web ou seu aplicativo cliente.
Use um navegador ou um cliente que envie HTML bruto — a maioria dos clientes oficiais e interfaces web fazem isso. - Digite o conteúdo da sua postagem com tags HTML.
Para texto em negrito, envolva a palavra ou frase com<b>e</b>. Para itálico, use<i>e</i>. Para um link, use<a href="URL">texto do link</a>. Exemplo:Isto é <b>negrito</b> e isto é <i>itálico</i>. - Publique a mensagem.
O servidor processa o HTML e renderiza a formatação para outros usuários que veem a postagem em sua timeline. Usuários em clientes que removem HTML verão as tags brutas — isso é raro em clientes modernos. - Verifique o resultado.
Veja sua postagem na interface web ou em outro cliente. O texto em negrito e itálico deve aparecer formatado.
Método 2: Usando Sintaxe Markdown em um Aplicativo Cliente com Suporte
- Instale um cliente com suporte a Markdown.
Exemplos incluem Tusky para Android e Fedilab para Android. No iOS, apps como Toot! ou Ivory podem oferecer opções Markdown — verifique as configurações deles. - Ative o Markdown nas configurações do app.
No Tusky, vá em Preferências > Postagem > Formatação Markdown e ative. No Fedilab, vá em Configurações > Post > Markdown. - Escreva sua postagem usando sintaxe Markdown padrão.
Use asteriscos duplos para negrito:texto em negrito. Use asteriscos simples para itálico:texto em itálico. Use crases para código inline:`código`. Use símbolos de hash para títulos:# Título. - Publique a mensagem.
O app converte Markdown em HTML antes de enviar. O servidor então aplica sua lista de permissões HTML. A maioria das tags comuns sobrevive a esse processo. - Verifique a saída.
Abra a postagem na interface web ou em outro cliente. Se o app usou tags que não estão na lista de permissões — por exemplo,<h1>— o servidor pode removê-las, deixando apenas texto simples.
Método 3: Usando Markdown em uma Instância Glitch-Soc
- Faça login na sua instância glitch-soc.
Instâncias glitch-soc geralmente têm “glitch” no nome de domínio ou são listadas em joinmastodon.org com o rótulo de software glitch-soc. - Abra suas preferências.
Clique no ícone de engrenagem (Preferências) na interface web. - Ative a renderização Markdown.
Em Preferências > Postagem, procure por uma caixa de seleção chamada “Formatação Markdown” ou “Ativar Markdown em postagens”. Marque-a e salve. - Escreva sua postagem com sintaxe Markdown.
Use a mesma sintaxe do Método 2. O servidor interpreta o Markdown e armazena a saída HTML. - Publique e confirme.
A postagem aparece formatada para todos os usuários, independentemente do cliente, porque o servidor já processou o Markdown.
Erros Comuns de Formatação e Limitações
Asteriscos ou Sublinhados Brutos Aparecem na Postagem
Este é o problema mais frequente. Se você digitar itálico em uma instância Mastodon padrão sem um cliente Markdown, o servidor trata os asteriscos como caracteres literais. O mesmo acontece com sublinhados. Para corrigir isso, use tags HTML <i> e <b> diretamente, ou mude para um cliente que converta Markdown antes de publicar.
Títulos e Blocos de Código São Removidos ou Quebrados
A lista de permissões HTML do Mastodon não inclui <h1> a <h6> nem <pre> e <code> para elementos de bloco. Se você usar títulos Markdown ou blocos de código cercados em um aplicativo cliente, o servidor removerá essas tags. O texto permanece, mas perde toda a formatação. Para código inline, use crases em um cliente Markdown — o cliente os converte em tags <code>, que estão na lista de permissões de muitas instâncias. Verifique sua instância postando um teste com <code>teste</code>.
Biografia e Campos do Perfil Nunca Mostram Formatação
A interface web e os aplicativos móveis oficiais renderizam a biografia e os campos de metadados do perfil como texto simples. Mesmo se você colar HTML ou Markdown lá, ele aparece como texto bruto. Alguns front-ends personalizados ou clientes alternativos podem renderizar HTML em biografias, mas isso não é padrão. Para adicionar ênfase na sua biografia, use emojis ou quebras de linha — quebras de linha são preservadas em campos de texto simples na maioria dos clientes.
Formatação Desaparece Após Editar uma Postagem
Quando você edita uma postagem no Mastodon, o servidor reprocessa o conteúdo. Se você usou tags HTML originalmente, o diálogo de edição pode mostrar as tags brutas, e você deve reinseri-las. Alguns clientes perdem a conversão Markdown após a edição. Para evitar isso, sempre reaplique a formatação ao editar.
Mastodon Padrão vs Glitch-Soc vs Markdown em Aplicativos Cliente
| Item | Mastodon Padrão | Fork Glitch-Soc | Markdown em App Cliente |
|---|---|---|---|
| Método de formatação padrão | Tags HTML da lista de permissões | Markdown ou HTML (escolha do usuário) | Markdown convertido para HTML |
| Texto em negrito | <b>texto</b> |
texto ou <b> |
texto convertido para <b> |
| Texto em itálico | <i>texto</i> |
texto ou <i> |
texto convertido para <i> |
| Títulos | Não suportado | Suportado via Markdown | Suportado apenas se o cliente converter para tags permitidas |
| Código inline | <code>texto</code> (se a instância permitir) |
Crases ou <code> |
Crases convertidos para <code> |
| Formatação da biografia do perfil | Nenhuma | Nenhuma | Nenhuma (apenas texto simples) |
O sistema de formatação do Mastodon é intencionalmente limitado para manter as postagens seguras e consistentes entre os clientes. Agora você pode aplicar negrito, itálico e links em suas postagens usando tags HTML onde a instância as suporta. Para formatação mais avançada, como títulos e blocos de código, considere ingressar em uma instância glitch-soc ou usar um aplicativo cliente com suporte a Markdown. Lembre-se de que os campos de perfil nunca renderizam formatação na interface oficial, então use texto simples com quebras de linha ou emojis para ênfase visual.