Esta guía de referencia detalla todas las opciones de formato disponibles en las publicaciones de Discourse, incluyendo markdown, BBCode y HTML. Especifica lo que es compatible y proporciona recursos donde puedes ver ejemplos.
Nivel de usuario requerido: Todos los usuarios
Entendiendo el formato compatible en las publicaciones
Si bien el texto sin formato es suficiente para la mayoría de las respuestas, Discourse permite a los usuarios mejorar el formato de sus publicaciones utilizando markdown, BBCode y HTML. Esta guía explica qué tipos de formato son compatibles y cómo puedes usarlos de manera efectiva.
También puedes practicar algunos de los conceptos básicos en un tutorial interactivo enviando un mensaje personal a @discobot aquí o en cualquier sitio de Discourse.
Resumen
Esta guía cubre:
- Sintaxis de markdown compatible
- Etiquetas BBCode compatibles
- Etiquetas y atributos HTML compatibles y seguros
Mejores prácticas
- Utiliza markdown principalmente por su simplicidad y legibilidad.
- Mezcla markdown y BBCode solo cuando sea necesario y mantén un uso consistente.
- Limita el uso de HTML a etiquetas simples y seguras para evitar problemas de formato y asegurar que las publicaciones sean seguras.
Markdown compatible
Discourse utiliza markdown-it para su implementación de markdown.
Algunas características de markdown de uso común incluyen:
-
Negrita:
**texto** -
Cursiva:
*texto* -
Enlace:
[título](https://example.com) -
Código en línea:`código` -
Resaltar:
<mark></mark> -
Bloque de código:
``` bloque de código ```
En publicaciones más largas (como esta), también puede ser útil añadir estructura usando encabezados:
# Encabezado 1
## Encabezado 2
### Encabezado 3
Nota: cuando se sube una imagen, la sintaxis de markdown para hacer referencia a la imagen se generará automáticamente.
Para una lista completa de características de markdown, consulta la guía interactiva.
BBCode compatible
Discourse admite un subconjunto de etiquetas BBCode comunes, algunas de las cuales se generan automáticamente para admitir formato especial, por ejemplo, cuando citas una publicación en tu respuesta:
[quote=“usuario”]texto citado[/quote]
[quote="usuario"]texto citado[/quote]
También puedes usar BBCode para marcar texto oculto como spoiler o como detalles
texto revelado
[spoiler]texto revelado[/spoiler]
[details=“clic para expandir”]texto oculto[/details]
[details="clic para expandir"]texto oculto[/details]
También son compatibles las etiquetas BBCode para formato simple compatibles con markdown:
[b]texto en negrita[/b][i]énfasis[/i][u]subrayado[/u][s]tachado[/s][ul][li]opción uno[/li][/ul][img]http://example.com/image.png[/img][url]http://example.com[/url][code]código[/code]
Para una lista completa de etiquetas BBCode compatibles y ejemplos, consulta las pruebas de Discourse BBCode.
HTML compatible
Discourse admite un subconjunto seguro de HTML. Si bien puedes mezclar HTML con markdown, solo se permiten etiquetas y atributos HTML específicos para garantizar la seguridad y un estilo consistente.
Algunas de las etiquetas HTML permitidas incluyen:
<a href="https://example.com">enlace</a><strong>texto en negrita</strong><em>texto en cursiva</em><ul><li>elemento de lista</li></ul><img src="https://example.com/image.png" alt="descripción">
Para una lista detallada de etiquetas y atributos HTML permitidos, consulta la lista de permitidos de Discourse.
Nota: Los estilos en línea, como <span>texto con color</span>, no son compatibles. Para estilos personalizados, consulta personalizar el contenido de las publicaciones.
Problemas comunes y soluciones
- Las etiquetas BBCode o HTML no funcionan: Asegúrate de que las etiquetas que estás utilizando formen parte del subconjunto compatible.
- Los estilos en línea se eliminan: Discourse no admite estilos en línea por razones de seguridad. Utiliza estilos personalizados o complementos si es necesario.
- El formato cambia al pegar desde otros editores: Algunos formatos de texto enriquecido pueden no renderizarse correctamente. Utiliza markdown para formatear el texto de manera consistente.
Preguntas frecuentes
P: ¿Puedo usar tablas en Discourse?
R: Sí, puedes usar markdown para crear tablas. Para más información, consulta esta guía sobre tablas.
P: ¿Por qué no funciona mi estilo en línea?
R: Discourse no admite estilos en línea en HTML por razones de seguridad. Considera usar BBCode personalizado o la guía de estilo personalizado de Discourse.
P: ¿Puedo añadir etiquetas BBCode personalizadas?
R: Sí, puedes añadir etiquetas BBCode personalizadas. Consulta el plugin BBCode de Discourse para más información.
Recursos adicionales
- Guía interactiva de markdown: https://markdown-it.github.io/
- Personalizar el contenido de las publicaciones: Customize posts' contents with your own styles
- Plugin BBCode de Discourse: Discourse BBCode
