Visualiza tus Notas Markdown Versión Web con MkDocs

Voy a explicaros como instalar MkDocs, levantar un servidor y poder ver todas vuestras nota en una interfaz web.

Instalación

Instalaremos en debian, ubuntu,… con:

sudo apt install mkdocs

También podemos hacerlo por Python así:

sudo pip install mkdocs

Ahora vamos a crear un nuevo proyecto, una carpeta donde depositaremos todas nuestras notas para después verlas en la web.

mkdocs new my-project
cd my-project

mkdocs serve

Para acceder remotamente, desde cualquier dispositivo dentro de nuestra red local, ejecutaremos dentro de la carpeta anteriormente creada:

mkdocs serve -a 0.0.0.0:8000

Ahora nos conectaremos desde cualquier dispositivo a: http://ip:8000

Si quieres publicarlo en tu servidor web de un modo permanente, con un comando podremos generar un sitio estático a partir de nuestro MkDocs.

Nos situamos en la raíz de la carpeta, donde arrancamos el servidor y ejecutamos:

mkdocs build

Esto creará una carpeta llamada site, que contendrá todos los archivos de nuestra web estática.

Publicado por Angel el Thursday 03 January del 2019