Markdown es un formato de escritura; HTML es un formato de publicación. Por ende, la sintaxis de Markdown no pretende ofrecer la versatilidad total de HTML, sino solo los elementos más comunes para el texto escrito. Cuando necesites hacer algo más complicado, puedes usar cualquier etiqueta HTML intercalada y etiquetas de nivel de bloque que sean compatibles con DevSite en un archivo de Markdown. No es necesario indicar que vas a cambiar de Markdown a HTML; solo usa la etiqueta HTML como en el siguiente ejemplo.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML intercalado
Las etiquetas HTML intercaladas se pueden usar dentro de un párrafo, elemento de lista o encabezado de Markdown, y también pueden contener sintaxis de Markdown (p.ej., **strong**, *emphasis*, etc.) Esto es útil cuando quieres llamar la atención sobre un fragmento del código, como en el siguiente ejemplo.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML de nivel de bloque
Las etiquetas HTML a nivel de bloque compatibles con DevSite deben estar separadas del contenido que las rodea con una línea en blanco. Y, a diferencia de las etiquetas HTML intercaladas, la sintaxis de Markdown (p.ej., **strong**, *emphasis*, etc.) en las etiquetas HTML de nivel de bloque no se renderizan como en el siguiente ejemplo.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Prácticas recomendadas
Recomendamos dar formato al HTML en los archivos de Markdown de las siguientes maneras para evitar errores de renderización en DevSite.
No uses etiquetas HTML de nivel de bloque no compatibles. DevSite admite muchas etiquetas HTML a nivel de bloque. pero si incluyes uno no compatible, tu HTML se renderizará como texto o romperá el código.
No agregues tabulaciones ni espacios adicionales al aplicar sangría. Las etiquetas de inicio y finalización en el nivel de bloque no deben tener sangrías de tabulaciones ni espacios. Algunos editores agregan automáticamente pestañas o espacios adicionales, ¡ten cuidado!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
No olvides que el código sin sangría es relativo
Por ejemplo, no necesitas aplicar sangría a las etiquetas de inicio y fin a nivel de bloque cuando creas listas en Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
No agregues una línea en blanco entre las etiquetas de inicio y finalización.
Esto es fácil de hacer cuando cambias entre Markdown y HTML, pero una simple línea en blanco puede representar fácilmente una página de forma incorrecta.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.