Markdown: guía completa

11. CommonMark {#11-commonmark}

11.1 Qué es y por qué existe {#111-qué-es-y-por-qué-existe}

CommonMark es una especificación formal, sin ambigüedades, de la sintaxis Markdown, acompañada de una suite de pruebas (spec tests) y de implementaciones de referencia (cmark en C, commonmark.js en JavaScript). Nació (≈2014, inicialmente como “Standard Markdown”) por iniciativa de John MacFarlane y otros desarrolladores para resolver las inconsistencias entre implementaciones del Markdown original.

11.2 Objetivos {#112-objetivos}

  • Describir de forma precisa cómo se interpreta cada construcción.
  • Ofrecer casos de prueba con la salida HTML esperada.
  • Ser una base común sobre la que construir extensiones (GFM es el ejemplo principal).
  • Mantener el espíritu original de legibilidad.

11.3 Diferencias relevantes con el Markdown original {#113-diferencias-relevantes-con-el-markdown-original}

Aspecto Original CommonMark
Especificación Descripción informal Especificación formal + tests
Título ATX #Título aceptado por algunas implementaciones Requiere espacio tras #
Listas Reglas ambiguas Reglas definidas (sangría, interrupción de párrafos)
Bloques de código con valla No definidos Definidos (``` y ~~~)
Énfasis Casos ambiguos Algoritmo de delimitadores definido
Saltos de línea duros Solo dos espacios Dos espacios o barra invertida
HTML en bloque Reglas parciales 7 tipos de bloque HTML definidos
Entidades HTML y escapes Parcialmente descritos Totalmente definidos

11.4 Compatibilidad y relación con GFM {#114-compatibilidad-y-relación-con-gfm}

CommonMark no incluye tablas, tachado, listas de tareas, notas al pie ni diagramas. Son extensiones que se añaden por encima (GFM las define en su especificación).

flowchart TB
    O[Markdown original<br/>Gruber 2004] --> C[CommonMark<br/>especificación]
    C --> G[GFM<br/>+ tablas, tareas, tachado, autolinks]
    G --> H[github.com<br/>+ menciones, alertas, Mermaid, etc.]
    C --> X[Otros dialectos<br/>Pandoc, markdown-it, etc.]

11.5 Especificación oficial {#115-especificación-oficial}

Comprueba en el sitio oficial cuál es la versión vigente antes de citarla en un documento normativo.