Generador de sitios web estáticos escrito en Python y centrado en la construcción de documentación.

La documentación se escribe con la sintaxis Markdown.

• Web oficial

pip install mkdocs

Para crear un nuevo proyecto:

mkdocs new miproyecto
cd miproyect

Veremos que se ha generado la siguiente estructura:

miproyecto/
├── docs
│   └── index.md
└── mkdocs.yml

• mkdocs.yml: fichero de configuración.
• docs: por defecto, el directorio que contendrá la documentación
• index.md: página con documentación.

Para previsualizar, podemos utilizar el servidor web que incluye mkdocs ejecutando, dentro del proyecto, lo siguiente:

mkdocs serve

Eso construirá la documentación y la tendremos accesible desde http://localhost:8000

mkdocs build

Esto creará un directorio llamado site donde se habrá generadon los ficheros necesarios para poder subirlos a cualquier servidor web y servir la documentación.