Este guia de referência detalha todas as opções de formatação disponíveis nas postagens do Discourse, incluindo markdown, BBCode e HTML. Ele especifica o que é suportado e fornece recursos onde você pode ver exemplos.
Nível de usuário necessário: Todos os usuários
Entendendo a formatação suportada em postagens
Embora o texto simples seja suficiente para a maioria das respostas, o Discourse permite que os usuários aprimorem a formatação de suas postagens usando markdown, BBCode e HTML. Este guia explica quais tipos de formatação são suportados e como você pode usá-los de forma eficaz.
Você também pode praticar alguns dos conceitos básicos em um tutorial interativo enviando uma mensagem pessoal para @discobot aqui ou em qualquer site do Discourse.
Sumário
Este guia abrange:
- Sintaxe markdown suportada
- Tags BBCode suportadas
- Tags e atributos HTML suportados e seguros
Melhores práticas
- Use markdown principalmente por sua simplicidade e legibilidade.
- Misture markdown e BBCode apenas quando necessário e mantenha o uso consistente.
- Limite o uso de HTML a tags simples e seguras para evitar problemas de formatação e garantir que as postagens estejam seguras.
Markdown Suportado
O Discourse usa markdown-it para sua implementação de markdown.
Alguns recursos de markdown comumente usados incluem:
-
Negrito:
**texto** -
Itálico:
*texto* -
Link:
[título](https://example.com) -
Código em linha:`código` -
Realçar:
<mark></mark> -
Bloco de código:
``` bloco de código ```
Em postagens mais longas (como esta), também pode ser útil adicionar estrutura usando títulos:
# Título 1
## Título 2
### Título 3
Nota: quando uma imagem é carregada, a sintaxe markdown para referenciar a imagem será gerada automaticamente.
Para uma lista completa de recursos de markdown, consulte o guia interativo.
BBCode Suportado
O Discourse suporta um subconjunto de tags BBCode comuns, algumas das quais são geradas automaticamente para suportar formatação especial, por exemplo, quando você cita uma postagem em sua resposta:
[quote=“usuário”]texto citado[/quote]
[quote="usuário"]texto citado[/quote]
Você também pode usar BBCode para marcar texto oculto como um spoiler ou como detalhes
texto estragado
[spoiler]texto estragado[/spoiler]
[details=“clique para expandir”]texto oculto[/details]
[details="clique para expandir"]texto oculto[/details]
Tags BBCode para formatação simples suportadas por markdown ou também são suportadas:
[b]forte[/b][i]ênfase[/i][u]sublinhado[/u][s]riscado[/s][ul][li]opção um[/li][/ul][img]http://example.com/image.png[/img][url]http://example.com[/url][code]código[/code]
Para uma lista completa de tags BBCode suportadas e exemplos, confira os testes BBCode do Discourse.
HTML Suportado
O Discourse suporta um subconjunto seguro de HTML. Embora você possa misturar HTML com markdown, apenas tags e atributos HTML específicos são permitidos para garantir segurança e estilo consistente.
Algumas das tags HTML permitidas incluem:
<a href="https://example.com">link</a><strong>texto em negrito</strong><em>texto em itálico</em><ul><li>item da lista</li></ul><img src="https://example.com/image.png" alt="descrição">
Para uma lista detalhada de tags e atributos HTML permitidos, consulte a lista de permissões do Discourse.
Nota: Estilos em linha, como <span>texto colorido</span>, não são suportados. Para estilos personalizados, consulte personalizar o conteúdo das postagens.
Problemas comuns e soluções
- Tags BBCode ou HTML não funcionando: Certifique-se de que as tags que você está usando fazem parte do subconjunto suportado.
- Estilos em linha sendo removidos: O Discourse não suporta estilos em linha por motivos de segurança. Use estilos personalizados ou plugins, se necessário.
- Mudanças de formatação ao colar de outros editores: Alguns formatos de texto rico podem não ser renderizados corretamente. Use markdown para formatar o texto de forma consistente.
FAQs
P: Posso usar tabelas no Discourse?
R: Sim, você pode usar markdown para criar tabelas. Para mais informações, consulte este guia sobre tabelas.
P: Por que meu estilo em linha não está funcionando?
R: O Discourse não suporta estilos em linha em HTML por motivos de segurança. Considere usar BBCode personalizado ou o guia de estilo personalizado do Discourse.
P: Posso adicionar tags BBCode personalizadas?
R: Sim, você pode adicionar tags BBCode personalizadas. Consulte o plugin BBCode do Discourse para mais informações.
Recursos adicionais
- Guia interativo de markdown: https://markdown-it.github.io/
- Personalizar o conteúdo das postagens: Customize posts' contents with your own styles
- Plugin BBCode do Discourse: Discourse BBCode
