MkDocs

MkDocs es un generador de sitios estáticos diseñado para crear documentación de proyectos . Está escrito en Python y también se utiliza en otros entornos.

MkDocs convierte archivos Markdown en páginas HTML , creando así un sitio web estático que contiene documentación.

Markdown es extensible, y el ecosistema MkDocs explota su naturaleza extensible a través de una serie de extensiones ^{[ 2 ] [ 3 ]} que ayudan a generar automáticamente documentación a partir del código fuente, agregar advertencias, escribir notación matemática, insertar notas al pie, resaltar el código fuente, etc.

MkDocs proporciona dos temas integrados: el tema predeterminado (basado en Bootstrap ) y el tema Read the Docs . Muchos de los temas de terceros disponibles se enumeran en el catálogo oficial, ^{[ 4 ]} incluyendo el popular tema Material for MkDocs. ^{[ 5 ]}

La primera versión etiquetada de MkDocs, la versión 0.2, salió el 21 de enero de 2014. ^{[ 6 ]}

A principios de 2015, Read the Docs admitía la creación de documentación con MkDocs, además de Sphinx . En preparación para el lanzamiento de la versión 0.12, ^{[ 7 ]} MkDocs comenzó a usar Read the Docs para el alojamiento. ^{[ 8 ]}

En enero de 2016, MkDocs añadió soporte para temas instalables. ^{[ 9 ]} Al mes siguiente, Martin Donath comenzó a desarrollar el tema Material para MkDocs. En los años siguientes, el tema se hizo muy popular y en julio de 2020 el modelo de desarrollo cambió a sponsorware, donde las nuevas funciones se lanzan primero a la versión Insiders y están disponibles públicamente una vez que se alcanzan los objetivos de financiación. ^{[ 10 ]}

El tema de Martin Donath se convirtió en un proyecto propio (Material para MkDocs).) y estuvo activo durante casi 10 años. Después de no estar activo durante algún tiempo, Donath anunció que abandonaba el uso de MkDocs debido a limitaciones inherentes y escribió un nuevo motor estático desde cero en un nuevo proyecto llamado Zensical ^{[ 11 ].}

En marzo de 2026, tras algunos cambios en la lista de mantenedores, ^{[ 12 ] [ 13 ] [ 14 ]} la creadora original de MkDocs (Mia Kimberly Christie - @lovelydinosaur) retomó el control del repositorio y anunció que la versión v2.0 de MkDocs está en desarrollo.

MkDocs ofrece soporte integrado para la implementación en GitHub Pages. Otras alternativas, como GitLab y Cloudflare Pages, ofrecen soporte nativo para la implementación de sitios MkDocs. ^{[ 15 ] [ 16 ]}

Muchas empresas utilizan MkDocs con el tema Material para desplegar su documentación, incluidas Atlassian , ^{[ 17 ]} Google , ^{[ 18 ]} Microsoft , ^{[ 19 ]} y Red Hat . ^{[ 20 ]} También es una opción popular entre proyectos de código abierto, como Electron , ^{[ 21 ]} Kubernetes , ^{[ 22 ]} y WebKit . ^{[ 23 ]}

• Comparación de generadores de documentación
• JAMstack

• MkDocs
• Read the Docs es un servidor de documentación colaborativo a gran escala impulsado por Sphinx, MkDocs y Jupyter Book.