Acerca de Vista previa de Markdown

Markdown Preview renderiza código Markdown en una vista legible para revisar títulos, listas, enlaces, citas, tablas y bloques de código.

Úsalo antes de enviar un README, fragmento de documentación, issue o borrador de blog.

Cómo usar Markdown Preview

Pega tu fuente Markdown.
Usa el ejemplo para revisar tablas GFM, bloques de código y enlaces.
Revisa jerarquía de títulos, indentación de listas y enlaces.

Cuándo usarlo

Comprobar lenguajes de bloques de código y alineación de tablas antes de commitear un README.
Previsualizar un issue de GitHub o release note antes de publicar.
Inspeccionar snippets de documentación API para títulos y listas anidadas.

Sintaxis Markdown y trampas de formato

Markdown es ligero, pero líneas en blanco, indentación y cantidad de backticks cambian el render. GitHub Flavored Markdown añade tablas, task lists y fenced code blocks.

Los títulos usan # y deben seguir una jerarquía lógica.
Las listas anidadas dependen de indentación; mezclar tabs y espacios rompe el layout.
Los bloques fenced usan triple backticks y pueden incluir lenguaje.
El texto de enlace debe ser descriptivo, no solo “click here”.

Preguntas frecuentes sobre Vista previa Markdown

¿Soporta GitHub Flavored Markdown?: Features comunes como tablas, fenced code blocks y task lists se pueden previsualizar, pero el resultado final depende de la plataforma destino.
¿Por qué falla mi lista anidada?: Suele ser indentación o líneas en blanco. Indenta hijos más que el padre y conserva el mismo estilo de marcador.
¿Mi contenido se sube?: No. El render Markdown se ejecuta localmente en el navegador y no se sube a wetool.site.

Markdown Preview vs publicación

La preview detecta muchos problemas, pero GitHub, npm, foros y CMS pueden usar extensiones y sanitizadores distintos. Revisa en la plataforma final antes de publicar.

Comparación de dialectos Markdown

Una preview ayuda a detectar problemas de estructura, pero los dialectos Markdown cambian entre plataformas.

CommonMark cubre sintaxis base como headings, paragraphs, lists, blockquotes y code blocks.
GitHub Flavored Markdown añade extensiones comunes como tables, task lists, strikethrough y autolinks.
Blogs, CMS y documentation sites pueden añadir front matter, heading anchors, footnotes o math formulas.

Render seguro y límites de publicación

Markdown preview no es el entorno final de publicación, sobre todo para HTML, imágenes, enlaces externos y filtros de plataforma.

No trates Markdown no confiable como HTML seguro; las plataformas destino suelen sanitize raw HTML.
External images y links pueden exponer solicitud sources, token parameters o internal addresses al publicar.
Antes de publicar README, npm docs o CMS pages, revisa el render final en la plataforma destino.