Marp: la herramienta de presentaciones en Markdown (y cómo exportar a PowerPoint)
Marp es el ecosistema de presentaciones en Markdown de código abierto: escribe las diapositivas en Markdown y luego expórtalas a HTML, PDF o PowerPoint con la Marp CLI. Esta guía cubre los temas de Marp, la escritura en Markdown, la exportación a pptx (como imágenes) con marp-cli, cómo se compara con reveal.js y Slidev, y dónde encaja un Agent-Native Design Workspace.
Si buscaste «marp» esperando un término dental u ortodóncico, este es el otro: Marp es el Markdown Presentation Ecosystem, un proyecto de código abierto (MIT) del equipo marp-team en GitHub para crear presentaciones escribiendo Markdown puro. Sin arrastrar cajas por un lienzo, sin formato de archivo propietario. Escribes # Slide title y unas viñetas, añades una directiva o dos, y Marp lo convierte en una presentación. (El «MARPE» sin relación que quizá hayas visto es un procedimiento de expansión maxilar en ortodoncia, nada que ver con las diapositivas. Este artículo trata estrictamente de Marp, la herramienta de presentaciones.)
Marp es la opción más sencilla y más nativa de Markdown entre las herramientas de presentaciones de código abierto, y por eso mismo los desarrolladores recurren a ella. Esta es una guía honesta sobre qué es Marp, cómo funcionan la escritura y los temas, cómo la Marp CLI exporta a PowerPoint y PDF (y la única salvedad que pilla a la gente por sorpresa), cómo se compara con reveal.js y Slidev, y dónde toma el relevo un design workspace cuando Markdown se queda corto.
Qué es Marp
Marp es un pequeño ecosistema de herramientas construido en torno a una idea: diapositivas como Markdown. Tiene tres piezas móviles. Marpit es el framework de bajo nivel que convierte Markdown más un tema en el HTML y CSS de las diapositivas. Marp Core es el motor con todo incluido que se apoya en Marpit, con un tema por defecto, gestión de imágenes y soporte de fórmulas. Marp CLI (marp-team/marp-cli) es la herramienta de línea de comandos que renderiza tu archivo Markdown a HTML, PDF o PowerPoint. También existe una extensión oficial de VS Code que te ofrece una vista previa lado a lado en tiempo real mientras escribes.
Escribes en un único archivo .md. Las diapositivas se separan con ---, los ajustes por diapositiva y globales se establecen mediante directivas de Marp (como theme:, paginate: o class:), y todo permanece como texto plano versionable. En eso reside todo su atractivo: tu presentación hace diff limpio en Git, vive junto a tu código y nunca te encierra en un formato binario.
Temas de Marp y escritura en Markdown
Escribir una presentación de Marp es deliberadamente minimalista. Un bloque de front-matter al inicio del archivo fija las directivas globales, --- separa las diapositivas, y el Markdown estándar —encabezados, listas, bloques de código, imágenes, tablas— se convierte en tu contenido. Como Marp renderiza a HTML y CSS bajo el capó, todo lo que Markdown expresa se traduce en una diapositiva sin sintaxis adicional que aprender.
Los temas de Marp son simplemente CSS. Marp Core incluye un puñado de temas integrados (default, gaia, uncover), y cambias entre ellos con una sola directiva theme:. Cuando los integrados no bastan, escribes tu propio tema como archivo CSS: apunta a las clases que expone Marpit, regístralo en la CLI mediante --theme o --theme-set, y cada diapositiva lo adopta. Para ajustes en línea puedes colocar un bloque <style> con alcance limitado en una sola diapositiva. Este modelo nativo de CSS es a la vez el techo y el suelo de Marp: si te manejas con CSS tienes control total, y si no, los valores por defecto igual se ven pulcros.
Exportar Marp a PowerPoint y PDF
La exportación es donde la Marp CLI se gana su lugar. Apúntala a tu Markdown y elige un destino:
- HTML —
marp deck.md -o deck.htmlproduce una presentación web autónoma que expones en el navegador. - PDF —
marp deck.md --pdfrenderiza un PDF listo para imprimir, ideal para materiales de apoyo y para compartir. - PowerPoint —
marp deck.md --pptxexporta un archivo.pptxque puedes abrir en PowerPoint o Keynote.
La única salvedad que conviene decir sin rodeos: la exportación PPTX de Marp renderiza cada diapositiva como una imagen, no como formas nativas y editables de PowerPoint. Cada diapositiva se convierte en una imagen a sangre dentro del envoltorio .pptx. Es perfecto cuando necesitas entregar un archivo a alguien que vive en PowerPoint y solo tiene que presentarlo, pero, una vez exportado, no puedes hacer clic para editar un cuadro de texto, recolorear una forma ni mover una viñeta. Si tu flujo de trabajo necesita seguir editando en PowerPoint después, trata el pptx de Marp como un formato de entrega, no como un formato fuente. (Han aparecido y desaparecido modos de exportación «editable» experimentales; el comportamiento fiable y documentado es una imagen por diapositiva.)
Marp vs Slidev vs reveal.js
Marp no es la única herramienta de presentaciones con enfoque Markdown-first. Aquí va la comparación honesta según los ejes que deciden tu elección:
| Herramienta | Escritura | Exportación PPTX editable | Plantillas | Licencia |
|---|---|---|---|---|
| Marp | Markdown puro + directivas | pptx como imágenes (no formas editables) | Temas CSS | MIT |
| reveal.js | HTML (plugin de Markdown opcional) | Sin pptx nativo | Temas HTML/CSS | MIT |
| Slidev | Markdown + componentes Vue | Sin pptx nativo (PDF/PNG/SPA) | Temas Vue + Windi/UnoCSS | MIT |
| Open Design | Descríbeselo a tu agente | Presentación editable sobre un design system | Design system + biblioteca de plantillas | Apache-2.0 |
Marp es la elección cuando quieres la menor ceremonia posible: un único archivo Markdown y una CLI. reveal.js es el maduro framework de diapositivas web: HTML-first, personalizable sin fin y con la experiencia más rica en el navegador, pero escribes HTML y no hay una vía nativa a PowerPoint. Slidev se sitúa en medio, para desarrolladores que quieren Markdown más componentes Vue reales, resaltado de código e integraciones interactivas: más potencia que Marp, pero también más configuración. Las tres están bajo licencia MIT y ninguna exporta nada directamente editable en PowerPoint.
Dónde encaja Open Design
Marp destaca exactamente en una cosa: tomar el Markdown que ya has escrito y convertirlo en diapositivas. Pero te pide a ti que escribas la presentación: la estructura, la redacción, el CSS del tema. No genera el contenido, no lo mantiene fiel a la marca entre proyectos ni te da un artefacto editable una vez exportado.
Open Design es la capa por encima de eso. Es un Agent-Native Design Workspace de código abierto (Apache-2.0), local-first y con tus propias claves, que se sitúa fuera del agente de código que ya usas. En lugar de escribir Markdown a mano, describes la presentación que quieres y el agente genera una editable sobre un design system, con plantillas propias de presentaciones HTML en su biblioteca de plugins como punto de partida. No es un reemplazo del Marp escrito en Markdown: cuando ya tienes el contenido en Markdown y quieres una presentación rápida desde la línea de comandos, Marp es la herramienta adecuada. Cuando quieres que la presentación se genere, se mantenga fiel a la marca y siga siendo editable como parte de un flujo de diseño mayor, ese es el trabajo del workspace. Si ya haces diapositivas con un agente de código, mira cómo un agente de código crea presentaciones.
Preguntas frecuentes
¿Qué es Marp? Marp es el Markdown Presentation Ecosystem de código abierto del equipo marp-team en GitHub. Escribes diapositivas en Markdown y la Marp CLI las exporta a HTML, PDF o PowerPoint. Está bajo licencia MIT e incluye Marp Core, el framework Marpit y una extensión de VS Code. No tiene relación con el término ortodóncico «MARPE».
¿Cómo exporto una presentación de Marp a PowerPoint? Instala la Marp CLI (marp-cli) y ejecuta marp deck.md --pptx. Ten en cuenta que el .pptx exportado renderiza cada diapositiva como una imagen, no como formas nativas y editables de PowerPoint: es genial para la entrega, pero después no podrás editar el texto ni las formas dentro de PowerPoint.
¿Puede Marp exportar archivos de PowerPoint editables? No de forma fiable. El comportamiento PPTX documentado de Marp es una imagen por diapositiva. Si necesitas un .pptx nativamente editable con cuadros de texto y formas reales, Marp es la herramienta equivocada para ese paso.
¿Marp es gratis? Sí. Marp es de código abierto bajo la licencia MIT, así que es libre de usar, autoalojar y modificar.
Marp vs reveal.js vs Slidev, ¿cuál debería usar? Elige Marp para las presentaciones en Markdown puro más sencillas y una exportación fácil a PDF/pptx, reveal.js para un maduro framework de diapositivas web con enfoque HTML-first y personalización profunda, y Slidev para Markdown más componentes Vue interactivos. Las tres están bajo licencia MIT; ninguna exporta PowerPoint directamente editable.
La conclusión
Marp es la forma más limpia de convertir en diapositivas el Markdown que ya tienes: un único archivo .md, temas CSS y una CLI que exporta HTML, PDF y PowerPoint. Solo recuerda la única limitación honesta: el pptx sale como imágenes, así que trátalo como un formato de entrega y no como algo que seguirás editando en PowerPoint. Si tu necesidad es «tengo el Markdown, dame una presentación», es difícil superar a Marp. Cuando la presentación deba generarse, mantenerse fiel a la marca y seguir siendo editable dentro de un flujo de diseño mayor, ahí es donde toma el relevo un Agent-Native Design Workspace.