cuando se utiliza un encabezado markdown de primer nivel (#) en un tema, ¿resultará en h1 o h2 en la salida HTML?
Generará un <h1> 
¿Entonces eso significa que Discourse asume que es bueno tener múltiples etiquetas <h1> en una página? Parece que si el título del tema es h1, entonces los encabezados de primer nivel dentro de ese tema deberían ser h2 por defecto, ¿no?
Discourse no asume nada, generará lo que le pidas que genere.
Es una mejor práctica usar ## como encabezados de nivel superior dentro de una publicación, sin duda
1 me gusta
Esa es definitivamente algo de “educación del usuario” de la que creo que podríamos prescindir al no hacer que # sea un encabezado de nivel 1… 
¿Sabes si hay alguna manera de cambiar eso? ¿O al menos ocultar los encabezados de nivel 1 en la barra de herramientas? (Supongo que las personas que escriben directamente en Markdown son un objetivo de educación realista…)
1 me gusta
Sí, es bastante sencillo. El elemento de lista tiene un atributo data-name="heading-1" que puedes seleccionar con CSS
Jeje, yo también estaba investigando eso. En una prueba rápida, esto oculta la opción H1 tanto en el editor de texto sin formato como en el editor enriquecido:
button[data-name="heading-1"] {
display: none;
}
(¡Puede que me quede con esto! No veo muchas razones para ofrecer H1 en el editor).
2 Me gusta
Puedo ver tu punto, pero esto no es algo que Discourse haya decidido de una manera u otra. Discourse sigue una convención de markdown llamada CommonMark, y especifica que # debe convertirse en un H1. Creo que esta convención sobre cómo se convierten los encabezados de markdown en etiquetas HTML es bastante estándar en las principales especificaciones de markdown.
1 me gusta
Bueno, dos encabezados <h1> no es una pregunta tan grande en realidad. Es un meme de SEO muy antiguo que dejó de ser un problema hace mucho tiempo. Google y otros usarán el primero o el que consideren más adecuado.
Podemos discutir si dos encabezados principales son el movimiento más inteligente en cuanto al contenido, pero cuando una plataforma utiliza un estilo diferente para el nombre del tema y los encabezados en las publicaciones, realmente no importa.
Aun así, es más apropiado usar ##/<h2> en las publicaciones. Pero como no juega ningún papel real, mi opinión es que es mejor que los usuarios usen encabezados que eviten esos porque tienen miedo de usar encabezados “incorrectos” 
1 me gusta
Los encabezados pueden ser solo una pequeña señal para el SEO hoy, pero todavía no me gustan las múltiples H1 porque soy un nerd. 
También estoy pensando en cómo Steph está creando documentación imprimible para la Publicación de Páginas, donde los H1 en la publicación se están renderizando aún más grandes que el H1 superior de la página:
Convertirlos en H2 los mantendría un poco más pequeños que el H1 superior:
1 me gusta
Sí, ese es el problema. Para mí es natural usar primero el encabezado de primer nivel, pero si el tema no está estilizado con la misma suposición, queda desordenado. Hay una especie de desconexión aquí.
(Nota al margen: ¿te está mostrando el documento en inglés sin ninguna intervención por tu parte?!?)
Eso es natural, sí, y tiene sentido cuando estás construyendo una página web desde cero. Pero un CMS o sistema de publicación casi siempre obtiene el H1 de la página de un campo de título, por lo que normalmente recurrirías a H2 para las secciones de contenido.
(Y usé la herramienta de traducción del navegador web para obtener el inglés).
1 me gusta
Estoy de acuerdo. Pero no deberíamos esperar que los miembros de la comunidad tengan que saber eso, en mi humilde opinión.
Sí, y no veo ninguna desventaja en simplemente ocultar la opción H1.
Aunque no veo mucho uso de encabezados por parte de la mayoría de los usuarios que hacen publicaciones típicas. Las personas que crean temas de documentación más largos probablemente tienen (o pronto tendrán) un poco más de experiencia con ## y ese ícono “TT”.
(Además: acabo de notar esta interesante discusión antigua donde se sugiere que los encabezados solo deben usarse en temas y no permitirse en las respuestas: Deshabilitar encabezados en respuestas como h1 y h2)
1 me gusta