Saltar al contenido

Vista previa Markdown

Escribe Markdown y revisa el resultado final en tiempo real.

Usar Vista previa Markdown

Cargando vista previa Markdown...

Qué puedes resolver con esta herramienta

  • Vista previa en directo mientras escribes.
  • Admite tablas, listas de tareas y enlaces automáticos (GFM).
  • Seguro: no ejecuta HTML incrustado.

Antes de empezar

La vista previa se renderiza en cliente con soporte para tablas, listas y otros formatos habituales de Markdown.

Qué hace Vista previa Markdown

Escribe Markdown y ve al momento cómo queda, con soporte para tablas, listas de tareas y tachado (GitHub Flavored Markdown). Útil para README, documentación, notas y mensajes con formato.

Casos de uso habituales

  • Revisar un README antes de subirlo a GitHub.
  • Preparar documentación técnica o notas con formato.
  • Aprender la sintaxis de Markdown viendo el resultado.
Guía editorial Calcliq

Guía técnica de sintaxis Markdown: CommonMark, GitHub Flavored Markdown (GFM) y renderizado seguro

Domina la sintaxis de documentación técnica, la construcción de tablas y listas de tareas, y los mecanismos de sanitización para prevenir vulnerabilidades XSS.

Evolución de Markdown: De la especificación de John Gruber a CommonMark y GFM

El lenguaje de marcado ligero Markdown fue concebido en 2004 por John Gruber con la colaboración de Aaron Swartz con un objetivo fundamental: permitir que los redactores escribieran documentos estructurados en texto plano sumamente sencillos de leer en su forma original, capaces de convertirse de manera directa e intuitiva en código HTML válido. A medida que Markdown se convirtió en el formato hegemónico para la documentación técnica, repositorios de código, plataformas de mensajería y sistemas de gestión de contenido, la ausencia de una gramática formal en la especificación original de 2004 generó divergencias entre analizadores. Para unificar el ecosistema, un grupo de trabajo integrado por ingenieros de GitHub, Stack Overflow y Reddit creó el estándar formal CommonMark, que define de forma inequívoca las reglas de precedencia, anidamiento de listas y tratamiento de espacios. Sobre la base de CommonMark, la especificación GitHub Flavored Markdown (GFM) introduce extensiones críticas para el desarrollo de proyectos y la colaboración técnica: tablas delimitadas por barras verticales (|), listas de tareas interactivas (- [ ] y - [x]), texto tachado con tildes de la eñe (~~texto~~), autovinculación de URLs y bloques de código cercados con triple comilla invertida que admiten la declaración del lenguaje de programación para resaltado de sintaxis.
Comparativa de sintaxis entre CommonMark, GFM y HTML nativo equivalente
Elemento de formatoSintaxis en Markdown (GFM)Código HTML equivalenteEstándar de soporteFinalidad en documentación técnica
Encabezados jerárquicos# Nivel 1 / ## Nivel 2<h1>...</h1> / <h2>...</h2>CommonMark / GFMJerarquía semántica, estructura de lectura y accesibilidad web
Tablas con alineación| Col1 | Col2 | |---|---| | A | B |<table><thead>...<tbody>...Extensión exclusiva GFMMatrices de datos, comparativas de versiones y especificaciones
Listas de tareas (Checklist)- [ ] Tarea - [x] Hecha<ul class="contains-task-list">...Extensión exclusiva GFMSeguimiento de roadmaps, hitos de sprint y listas de control
Texto tachado (Strikethrough)~~texto obsoleto~~<del>texto obsoleto</del>Extensión exclusiva GFMHistorial de cambios, versiones descartadas y notas de corrección
Bloques de código cercados```typescript const a = 1; ```<pre><code class="language-ts">...CommonMark / GFMEjemplos técnicos de código con sintaxis estructurada
Citas en bloque (Blockquotes)> Aviso o nota relevante<blockquote><p>...</p></blockquote>CommonMark / GFMAlertas, advertencias de seguridad y citas bibliográficas

Pipeline de renderizado en cliente y seguridad contra inyección XSS

La conversión de Markdown a elementos visibles del árbol DOM se ejecuta a través de un canal de procesamiento por etapas que garantiza rendimiento y protección contra inyecciones de código malicioso:
Flujo de compilación de árbol de sintaxis abstracta (AST) y aislamiento de seguridad
Fórmula matemática
Pipeline: Texto_Markdown → Tokenizador_Léxico → AST (Árbol Sintáctico) → HTML_Sanitizado → DOM
Complejidad temporal de compilación: O(N) lineal respecto al número de líneas del documento
Directriz de seguridad (XSS): Aislamiento y desinfección estricta que bloquea <script>, iframes y atributos onclick

Dado que Markdown permite la inserción de HTML en su sintaxis básica, los visores web profesionales desinfectan activamente el resultado o bloquean las etiquetas activas para evitar que archivos README compartidos ejecuten scripts no autorizados en el navegador del usuario.

Ejemplo práctico: Composición y previsualización de un archivo README.md técnico

Al publicar un paquete de software o un proyecto web, es habitual preparar un archivo README estructurado que combine insignias, tablas de compatibilidad y listas de tareas pendientes.
Redacción de documentación con tabla GFM y lista de verificación de entrega
Ejemplo práctico

Situación: Un desarrollador crea la guía de instalación de un módulo web que incluye una tabla de navegadores compatibles y una checklist de requisitos previos.

Paso 1: Se redacta el encabezado: ## Requisitos del sistema
Paso 2: Se define la tabla GFM:
| Navegador | Versión mínima | Estado |
|---|---|---|
| Chrome | 120+ | Soportado |
| Firefox | 115+ | Soportado |
| Safari | 17+ | Soportado |
Paso 3: Se añaden las tareas de despliegue:
- [x] Instalación de dependencias con pnpm
- [ ] Configuración de variables locales
Paso 4: El visor de Calcliq compila el texto en tiempo real, renderizando la tabla con bordes limpios y casillas interactivas sin parpadeos.

Resultado final: El texto plano se convierte instantáneamente en una interfaz visual enriquecida y profesional, lista para ser revisada y subida al repositorio de código.

Qué debes tener en cuenta

Estas notas ayudan a interpretar el resultado con prudencia y a evitar usos poco fiables.

El HTML escrito dentro del Markdown no se muestra, por seguridad.
No exporta a PDF ni a Word.

Herramientas relacionadas

Preguntas frecuentes sobre Vista previa Markdown

¿Cómo hago una tabla en Markdown?

Separa las columnas con | y pon una fila de guiones bajo la cabecera: | Nombre | Rol |, luego | --- | --- |, y después una fila por línea.

¿Qué es GitHub Flavored Markdown?

Una variante de Markdown que añade tablas, listas de tareas (- [ ]), tachado (~~texto~~) y enlaces automáticos. Es la que usan GitHub y muchas herramientas.

¿Se guarda lo que escribo?

No. El texto se queda en tu navegador y se pierde al recargar la página; cópialo antes de salir.