Markdown: organiza el significado antes de dar estilo
Markdown resulta útil para notas y documentación porque su fuente sigue siendo texto legible. Lo importante es distinguir títulos, párrafos y listas, no acumular marcas de formato.
Un título no es solo un tamaño de letra
Empieza por el tema del documento y sitúa sus secciones en niveles inferiores. # y ## seguidos de un espacio indican niveles distintos; convertir cada línea en título principal borra esa jerarquía.
Usa listas para elementos independientes y párrafos para explicar relaciones. El formato debe ayudar a una frase clara, no sustituirla.
Referencias: CommonMark 0.31.2 — Structured text, headings and rendering differences
La vista previa no representa todos los destinos
Las extensiones de Markdown varían. Que una tabla funcione en un editor no garantiza idéntico resultado en otro sistema; revisa el documento donde lo leerán sus destinatarios.
ToolRoof muestra y exporta HTML, pero no ejecuta el HTML introducido. Sustituye imágenes externas por descripciones y desactiva los enlaces de la vista previa. No reproduce páginas web completas.
Referencias: CommonMark 0.31.2 — Structured text, headings and rendering differences
Conserva también la fuente
La fuente Markdown facilita comparar modificaciones. HTML sirve para presentar el contenido, pero una conversión inversa no tiene por qué recuperar exactamente el original.
Revisa enlaces y contenido antes de compartirlo. Una vista previa no demuestra la veracidad del texto, la seguridad de los sitios enlazados ni el derecho a reutilizar materiales ajenos.
Ejemplo: una nota breve de reunión
Escribe # Plan semanal, después ## Prioridades y, en líneas separadas, - Revisar el resumen y - Enviar el borrador. Se obtienen un título principal, un subtítulo y 2 elementos de lista, no 4 párrafos iguales.
Sin el espacio, #Plan semanal no es un título ATX. El código entre acentos graves se muestra como texto: verlo no significa ejecutarlo ni demostrar que sea correcto.