Errores comunes en Markdown y cómo evitarlos

Esta guía trata errores comunes de Markdown y muestra cómo detectar fallos antes de romper renderizado, accesibilidad o mantenimiento. El objetivo no es una captura cualquiera, sino un recurso legible, vinculado a su fuente Markdown y reutilizable al publicar.

PNG conserva nítidos texto, código, tablas y líneas finas. JPEG puede pesar menos con fondos fotográficos, pero suaviza tipografía pequeña. PDF conviene para varias páginas y DOCX para edición de oficina. El formato debe responder al canal final.

1. Preparar. revisar títulos, líneas vacías, sangría, enlaces y alt.
2. Previsualizar. probar en un renderizador CommonMark y en el destino real.
3. Exportar. corregir la fuente y regenerar todos los derivados.

Pega este ejemplo pequeño para validar tipografía y espacio antes del contenido real.

# Clear heading

- Item one
- Item two

[Readable link](https://example.com)

![Useful alt text](https://example.com/chart.png)

CommonMark define el núcleo portable. Tablas, tareas y ciertos autolinks son extensiones GFM y pueden variar. Mermaid y KaTeX son sintaxis independientes que requieren renderizadores compatibles. Prueba siempre el destino final.

• Escribe alt útil para imágenes informativas.
• Mantén jerarquía y lectura lógicas.
• Comprueba contraste claro y oscuro.
• Revisa al tamaño real de publicación.
• Versiona la fuente Markdown.
• Reexporta tras cambios; no parches texto en el bitmap.

Evita letra mínima, tablas demasiado anchas, siglas sin explicar, imágenes remotas inestables y recortes sin contexto. No prometas render idéntico en todos los motores: extensiones y temas marcan el límite.

Los límites factuales se comprobaron con estas fuentes primarias:

• https://spec.commonmark.org/current/
• https://github.github.com/gfm/
• https://docs.github.com/en/get-started/writing-on-github

Abre MarkdownToImage y prueba el ejemplo con ancho y tema finales. Continúa con la primera guía y la segunda guía.