🔧 Opción 1: Usar MkDocs + Apache
Ideal para generar sitios estáticos desde Markdown y servirlos con Apache.
Paso a paso:
sudo apt update
sudo apt install apache2
pip3 install mkdocs mkdocs-material
mkdocs new my-docs
cd my-docs
mkdocs build
sudo cp -r site/* /var/www/html/
sudo systemctl restart apache2
🧩 Opción 2: Renderizado dinámico con mod_markdown
Permite que Apache interprete archivos .md
directamente como HTML.
Instalación:
sudo apt install build-essential libtool automake autoconf libmarkdown2-dev apache2-dev
git clone https://github.com/hamano/apache-mod-markdown
cd apache-mod-markdown
autoreconf -f -i
./configure --with-discount=/usr/include
make
sudo make install
Configuración en Apache:
LoadModule markdown_module /usr/lib/apache2/modules/mod_markdown.so
DirectoryIndex index.html index.md
AddHandler markdown .md
sudo systemctl restart apache2
🎯 Comparativa rápida
🔧 Enfoque | 🛠️ Tipo de renderizado | 🎓 Aplicación pedagógica |
---|---|---|
MkDocs + Apache | Estático (precompilado) | Ideal para documentación modular y benchmarking |
mod_markdown | Dinámico (en tiempo real) | Perfecto para debugging emocional y tooltips narrativos |
🧪 Editor Markdown recomendado
Explora Markdown en tiempo real con Dillinger.io