55. Recursos y documentación oficial {#55-recursos-y-documentación-oficial}
Los recursos se han agrupado por tipo. Se priorizan las fuentes oficiales y la documentación primaria; los recursos de terceros se identifican como tales. Las URLs se comprobaron en la fecha de redacción, pero los sitios pueden reorganizar sus rutas.
55.1 Especificaciones y estándares {#551-especificaciones-y-estándares}
| Nombre | Descripción | Para qué sirve | Enlace | Tipo |
|---|---|---|---|---|
| Markdown original | Página de John Gruber sobre Markdown | Referencia histórica y sintaxis original | https://daringfireball.net/projects/markdown/ | Documentación oficial (autor) |
| Markdown Syntax | Descripción detallada de la sintaxis original | Consultar el comportamiento original | https://daringfireball.net/projects/markdown/syntax | Documentación oficial (autor) |
| CommonMark | Sitio del proyecto CommonMark | Entender el núcleo formal | https://commonmark.org/ | Especificación / comunidad |
| CommonMark Spec | Especificación formal con ejemplos | Resolver dudas de sintaxis y conformidad | https://spec.commonmark.org/ | Especificación |
| CommonMark Dingus | Probador interactivo | Comparar la salida de un fragmento | https://spec.commonmark.org/dingus/ | Herramienta oficial |
| GFM Spec | Especificación de GitHub Flavored Markdown | Consultar las extensiones de GitHub | https://github.github.com/gfm/ | Especificación |
| HTML Standard | Estándar vivo de HTML | Entender el destino de la conversión | https://html.spec.whatwg.org/ | Especificación |
| MDN HTML | Documentación de HTML | Referencia práctica de elementos y atributos | https://developer.mozilla.org/en-US/docs/Web/HTML | Documentación (MDN) |
| Mermaid | Sitio oficial de Mermaid | Diagramas como código | https://mermaid.js.org/ | Documentación oficial |
| Mermaid Syntax | Referencia de sintaxis | Consultar tipos de diagramas | https://mermaid.js.org/intro/syntax-reference.html | Documentación oficial |
| Semantic Versioning | Especificación de versiones | Versionar bibliotecas y APIs | https://semver.org/ | Especificación |
| Keep a Changelog | Convención de changelogs | Escribir historiales de cambios | https://keepachangelog.com/ | Especificación / convención |
| WCAG 2.2 | Pautas de accesibilidad | Diseñar documentación accesible | https://www.w3.org/TR/WCAG22/ | Estándar W3C |
| RFC 7763 | Tipo de medio text/markdown |
Identificar Markdown en servicios | https://www.rfc-editor.org/rfc/rfc7763 | RFC |
| YAML 1.2 | Especificación de YAML | Validar Front Matter | https://yaml.org/spec/ | Especificación |
55.2 Documentación de plataformas {#552-documentación-de-plataformas}
| Nombre | Descripción | Para qué sirve | Enlace | Tipo |
|---|---|---|---|---|
| GitHub Docs: escribir en GitHub | Documentación de formato y sintaxis | Saber qué acepta GitHub | https://docs.github.com/en/get-started/writing-on-github | Documentación oficial |
| GitHub Docs: sintaxis básica | Guía de formato | Consultar ejemplos rápidos | https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax | Documentación oficial |
| GitHub Docs: diagramas | Crear diagramas Mermaid en Markdown | Usar Mermaid en GitHub | https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams | Documentación oficial |
| GitLab Markdown | Documentación de GitLab Flavored Markdown | Consultar diferencias y extensiones | https://docs.gitlab.com/user/markdown/ | Documentación oficial |
| VS Code Markdown | Soporte de Markdown en VS Code | Configurar edición y previsualización | https://code.visualstudio.com/docs/languages/markdown | Documentación oficial |
| Obsidian Help | Ayuda de Obsidian | Aprender wikilinks, callouts y plugins | https://help.obsidian.md/ | Documentación oficial |
| Jekyll Markdown | Configuración de Markdown en Jekyll | Elegir Kramdown o GFM | https://jekyllrb.com/docs/configuration/markdown/ | Documentación oficial |
| Kramdown Syntax | Sintaxis de Kramdown | Entender el dialecto de Jekyll | https://kramdown.gettalong.org/syntax.html | Documentación oficial |
| MkDocs Material | Tema y extensiones para documentación | Admoniciones, tabs, búsqueda | https://squidfunk.github.io/mkdocs-material/ | Documentación oficial |
| Python-Markdown | Implementación de Markdown en Python | Extensiones y API | https://python-markdown.github.io/ | Documentación oficial |
| Docusaurus: MDX y React | Uso de componentes en documentos | Crear documentación interactiva | https://docusaurus.io/docs/markdown-features/react | Documentación oficial |
| Next.js: MDX | Guía de MDX en Next.js | Integrar MDX en una app React | https://nextjs.org/docs/app/guides/mdx | Documentación oficial |
| Astro: MDX | Integración oficial de MDX | Usar MDX en Astro | https://docs.astro.build/en/guides/integrations-guide/mdx/ | Documentación oficial |
| Nextra | Framework de documentación sobre Next.js | Crear sitios de docs con MDX | https://nextra.site/ | Documentación oficial |
| Starlight | Tema de documentación para Astro | Documentación con componentes | https://starlight.astro.build/ | Documentación oficial |
| Fumadocs | Framework de documentación React | Docs con MDX y componentes | https://www.fumadocs.dev/ | Documentación oficial |
55.3 Herramientas {#553-herramientas}
| Nombre | Descripción | Para qué sirve | Enlace | Tipo |
|---|---|---|---|---|
| Pandoc | Conversor universal de documentos | Convertir Markdown a HTML, PDF, DOCX, EPUB, LaTeX | https://pandoc.org/ | Herramienta open source |
| Pandoc Manual | Manual completo | Consultar opciones y filtros | https://pandoc.org/MANUAL.html | Documentación oficial |
| markdownlint | Linter de Markdown | Detectar problemas de estilo | https://github.com/DavidAnson/markdownlint | Herramienta open source |
| markdownlint-cli2 | Cliente de markdownlint | Ejecutar el linter en CI | https://github.com/DavidAnson/markdownlint-cli2 | Herramienta open source |
| remark | Procesador de Markdown | Transformar y validar AST | https://github.com/remarkjs/remark | Herramienta open source |
| remark-lint | Reglas de linting sobre AST | Validación semántica | https://github.com/remarkjs/remark-lint | Herramienta open source |
| Prettier | Formateador de código y Markdown | Formato consistente | https://prettier.io/ | Herramienta open source |
| Vale | Linter de prosa | Consistencia de estilo | https://vale.sh/ | Herramienta open source |
| lychee | Comprobador de enlaces | Evitar enlaces rotos | https://github.com/lycheeverse/lychee | Herramienta open source |
| markdown-it | Parser y renderizador JavaScript | Integrar Markdown en una web | https://github.com/markdown-it/markdown-it | Herramienta open source |
| cmark | Implementación de referencia CommonMark | Convertir con CommonMark estricto | https://github.com/commonmark/cmark | Herramienta open source |
| mermaid-cli | CLI de Mermaid | Generar SVG/PNG/PDF | https://github.com/mermaid-js/mermaid-cli | Herramienta open source |
| Marked | Parser Markdown JavaScript | Conversión rápida | https://github.com/markedjs/marked | Herramienta open source |
| Python-Markdown | Implementación Python | Conversión y extensiones | https://python-markdown.github.io/ | Herramienta open source |
| Turndown | Conversor HTML → Markdown | Migrar contenido HTML | https://github.com/mixmark-io/turndown | Herramienta open source |
| md-to-pdf | Conversor Markdown → PDF | Generar PDF con Chromium | https://github.com/simonhaenisch/md-to-pdf | Herramienta open source |
55.4 Guías, aprendizaje y estilo {#554-guías-aprendizaje-y-estilo}
| Nombre | Descripción | Para qué sirve | Enlace | Tipo |
|---|---|---|---|---|
| Markdown Guide | Guía independiente de Markdown | Aprender sintaxis y herramientas | https://www.markdownguide.org/ | Recurso de terceros |
| CommonMark Tutorial | Tutorial oficial de CommonMark | Aprender el núcleo | https://commonmark.org/help/tutorial/ | Documentación oficial |
| GitHub Docs | Documentación general de GitHub | Flujos, repositorios y formato | https://docs.github.com/ | Documentación oficial |
| MDN Web Docs | Documentación web | HTML, CSS, accesibilidad y seguridad | https://developer.mozilla.org/ | Documentación (MDN) |
| WAI Tutorials | Tutoriales de accesibilidad | Aplicar WCAG | https://www.w3.org/WAI/tutorials/ | Documentación oficial |
| Diátaxis | Marco de documentación | Organizar tutoriales, guías, referencia y explicación | https://diataxis.fr/ | Recurso de terceros |
| Write the Docs | Comunidad de documentación | Buenas prácticas y eventos | https://www.writethedocs.org/ | Recurso de terceros |
| Google Developer Documentation Style Guide | Guía de estilo | Consistencia en documentación técnica | https://developers.google.com/style | Guía de estilo |
| Microsoft Writing Style Guide | Guía de estilo | Redacción técnica en inglés | https://learn.microsoft.com/en-us/style-guide/welcome/ | Guía de estilo |
| Choose a License | Guía de licencias | Elegir licencia para el proyecto | https://choosealicense.com/ | Recurso de terceros |
| Shields.io | Badges | Crear insignias para README | https://shields.io/ | Servicio de terceros |
| Contributor Covenant | Código de conducta | Añadir un código de conducta | https://www.contributor-covenant.org/ | Recurso de terceros |
55.5 Cómo usar estos recursos {#555-cómo-usar-estos-recursos}
- Para dudas de sintaxis: empieza por CommonMark Spec y GFM Spec.
- Para una plataforma concreta: consulta su documentación oficial, no un blog desactualizado.
- Para conversión: usa el manual de Pandoc y prueba con tus propios documentos.
- Para accesibilidad: WCAG 2.2 y los tutoriales WAI.
- Para seguridad: OWASP y la documentación del sanitizador que uses.
- Para documentación: Diátaxis y las guías de estilo, pero adáptalas a tu equipo.
Las URLs de documentación cambian con frecuencia. Si un enlace falla, busca el título del recurso en el sitio oficial correspondiente.