🔧 Opción 1: Usar generador estático (como MkDocs o Hugo)
Genera HTML desde Markdown y lo despliegas como aplicación web en Tomcat.
Pasos clave:
# Genera HTML con MkDocs
pip install mkdocs
mkdocs new mi-doc
cd mi-doc
mkdocs build
# Empaqueta como WAR
mkdir -p markdown-webapp
cp -r site/* markdown-webapp/
# Usa Maven o manualmente para crear el WAR
Despliega el WAR en $CATALINA_HOME/webapps
y reinicia Tomcat.
🧩 Opción 2: Renderizado dinámico con servlet Markdown
Usa una librería como flexmark-java para convertir Markdown a HTML en tiempo real.
Ejemplo de servlet:
// MarkdownServlet.java
import com.vladsch.flexmark.html.HtmlRenderer;
import com.vladsch.flexmark.parser.Parser;
public class MarkdownServlet extends HttpServlet {
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
String markdown = "# Hola Mundo\nEste es *Markdown*";
Parser parser = Parser.builder().build();
HtmlRenderer renderer = HtmlRenderer.builder().build();
String html = renderer.render(parser.parse(markdown));
resp.setContentType("text/html");
resp.getWriter().write(html);
}
}
Compila y despliega como WAR en Tomcat. Puedes usar JSP para integrar Markdown dinámico.
🎯 Comparativa rápida
🔧 Enfoque | 🛠️ Tipo de renderizado | 🎓 Aplicación pedagógica |
---|---|---|
Generador estático | Pre-renderizado (HTML) | Ideal para documentación modular y benchmarking |
Servlet dinámico | Markdown → HTML en tiempo real | Perfecto para debugging emocional y tooltips narrativos |