54. Estándares y especificaciones {#54-estándares-y-especificaciones}

Markdown no nació como un estándar formal. Hoy conviven el Markdown original, CommonMark y GFM, además de estándares independientes que se usan junto a él (HTML, YAML, Mermaid, SemVer, WCAG). Esta sección distingue qué es una especificación, qué es una convención y qué es una extensión de plataforma.

54.1 Marco general {#541-marco-general}

54.2 Markdown original {#542-markdown-original}

John Gruber publicó Markdown en 2004 como una sintaxis ligera y un script en Perl (Markdown.pl). La documentación original describe la sintaxis y el comportamiento esperado, pero no es una especificación formal: no define con precisión todos los casos límite.

• Sitio: https://daringfireball.net/projects/markdown/
• Sintaxis: https://daringfireball.net/projects/markdown/syntax

Es la referencia histórica. Cuando se dice “Markdown estándar” de forma coloquial, a menudo se quiere decir “Markdown original” o “CommonMark”, pero conviene precisar.

54.3 CommonMark {#543-commonmark}

CommonMark nació para resolver las ambigüedades del Markdown original. Define:

• Una gramática precisa.
• Una suite de ejemplos con salida HTML esperada.
• Implementaciones de referencia (cmark en C, commonmark.js en JavaScript).

• Un conjunto de extensiones posibles, que no forman parte del núcleo.

• Sitio: https://commonmark.org/
• Especificación: https://spec.commonmark.org/
• Tutorial: https://commonmark.org/help/tutorial/
• Dingus (probador): https://spec.commonmark.org/dingus/

CommonMark no incluye tablas, listas de tareas, tachado, notas al pie ni Mermaid. Esas funciones se añaden con extensiones o dialectos.

54.4 GitHub Flavored Markdown (GFM) {#544-github-flavored-markdown-gfm}

GFM es un superconjunto estricto de CommonMark. La especificación de GitHub define extensiones como:

• Tablas.
• Listas de tareas.
• Tachado.
• Autolinks extendidos.
• Filtro de etiquetas HTML peligrosas (tagfilter).

Además, github.com ofrece funciones que no están en la especificación GFM: alertas, Mermaid, matemáticas, notas al pie, menciones, referencias a issues, emojis, etc. Es importante no confundir “GFM” con “todo lo que hace GitHub”.

• Especificación: https://github.github.com/gfm/
• Documentación de GitHub: https://docs.github.com/en/get-started/writing-on-github

54.5 Mermaid {#545-mermaid}

Mermaid es una biblioteca independiente de JavaScript para generar diagramas a partir de texto. No forma parte de Markdown, CommonMark ni GFM. Plataformas como GitHub, GitLab, Obsidian, Docusaurus o MkDocs la integran, pero la sintaxis y el renderizado dependen de la versión y del plugin.

• Sitio: https://mermaid.js.org/
• Referencia de sintaxis: https://mermaid.js.org/intro/syntax-reference.html
• Repositorio: https://github.com/mermaid-js/mermaid
• Editor: https://mermaid.live/

54.6 HTML {#546-html}

HTML es el estándar de estructura de las páginas web. Markdown se convierte a HTML, pero no es HTML: no describe estilos, scripts ni el documento completo. HTML tiene su propia especificación (WHATWG) y su propia documentación (MDN).

• Especificación: https://html.spec.whatwg.org/
• MDN: https://developer.mozilla.org/en-US/docs/Web/HTML

54.7 Semantic Versioning {#547-semantic-versioning}

SemVer define el esquema MAJOR.MINOR.PATCH y las reglas para incrementar cada número. Es habitual en bibliotecas y se usa junto a los changelogs.

• Especificación: https://semver.org/
• Versión en español: https://semver.org/lang/es/

54.8 Keep a Changelog {#548-keep-a-changelog}

Keep a Changelog propone una estructura para los archivos CHANGELOG.md: secciones Added, Changed, Deprecated, Removed, Fixed y Security, con versiones y fechas.

• Sitio: https://keepachangelog.com/
• Versión en español: https://keepachangelog.com/es-ES/1.1.0/

54.9 WCAG {#549-wcag}

Las Web Content Accessibility Guidelines (WCAG) del W3C definen criterios de accesibilidad. La versión 2.2 es una recomendación estable; WCAG 3 está en desarrollo. Markdown puede contribuir a la accesibilidad con estructura, texto alternativo, enlaces descriptivos y tablas bien formadas.

• WCAG 2.2: https://www.w3.org/TR/WCAG22/
• Resumen: https://www.w3.org/WAI/WCAG22/quickref/
• WAI: https://www.w3.org/WAI/

54.10 RFC 7763 y el tipo de medio text/markdown {#5410-rfc-7763-y-el-tipo-de-medio-textmarkdown}

El RFC 7763 registra text/markdown como tipo de medio. No define la sintaxis, pero es útil para servidores, APIs y herramientas que necesitan identificar Markdown.

• RFC: https://www.rfc-editor.org/rfc/rfc7763

54.11 YAML y Front Matter {#5411-yaml-y-front-matter}

El Front Matter es una convención: un bloque YAML al inicio del archivo, delimitado por ---. No forma parte de Markdown. Los generadores de sitios lo usan para metadatos (título, fecha, borrador, etiquetas, etc.).

---
title: "Guía de instalación"
description: "Cómo instalar el proyecto"
date: 2026-10-28
tags: [instalación, linux]
draft: false
---

• YAML 1.2: https://yaml.org/spec/

54.12 Qué NO es un estándar {#5412-qué-no-es-un-estándar}

54.13 Cómo citar correctamente una característica {#5413-cómo-citar-correctamente-una-característica}

Cuando dokumentes una función, indica su origen:

• “En CommonMark, los encabezados ATX…”
• “En GFM, las tablas…”
• “En GitHub, las alertas…”
• “Con Mermaid (proyecto independiente)…”
• “En MDX, los componentes…”
• “En Obsidian, los wikilinks…”

Esta precisión evita afirmaciones falsas del tipo “Markdown permite Mermaid” o “GFM es el estándar”.