Markdown a PDF en Mac, desde la línea de comandos.
La herramienta gratuita marsdawn convierte un archivo Markdown en un PDF con un solo comando. Las tablas, las fórmulas, los diagramas Mermaid y el código resaltado salen tal como se leen en el código fuente, y no necesita nada más instalado, ni siquiera la app MarsDawn.
Instálala
brew install redtear1115/tap/marsdawn
marsdawn --version
En una Mac con chip de Apple, Homebrew instala una copia precompilada en segundos. En una Mac con Intel, la compila desde el código fuente, lo que tarda unos minutos y requiere Xcode 26 o posterior. Funciona en macOS 15 o posterior, y marsdawn --version muestra la versión que instalaste.
Guarda un documento
Pega esto en un archivo llamado plan.md:
# Plan: exportaciones más rápidas
Un agente escribió este plan. Tú lo revisas y luego lo conviertes en PDF.
## Pasos
| Paso | Responsable | Estado |
|------|-------------|--------|
| Medir las páginas lentas | Agente | Hecho |
| Guardar en caché los diagramas renderizados | Agente | En revisión |
El objetivo es $t < 2\,\text{s}$ para un documento de 50 páginas:
$$
t_{\text{total}} = \sum_{i=1}^{n} t_i
$$
```mermaid
graph LR
Borrador --> Revisión --> Publicación
```
```swift
let pdf = try export("plan.md")
```
Expórtalo
marsdawn export plan.md
Escribe plan.pdf junto al archivo fuente e indica dónde quedó:
Exported /Users/you/plan.pdf (1 page)
Esta es esa página, capturada de una ejecución real de marsdawn 0.5.0:

Elige un tema, un tamaño de papel y un nombre de archivo
marsdawn export plan.md --theme classic --paper letter -o handout.pdf
--theme: dawn, classic, modern o vivid, con los colores claros del tema. Sin esta opción,exportusa$MARSDAWN_THEMEy, si no existe, dawn.--paper: a4 o letter. El valor predeterminado es a4.-o: dónde escribir el PDF, en lugar de junto al archivo fuente.--allow-remote-images: carga imágenes de la web durante el renderizado. Quedan desactivadas a menos que la indiques.
Si no funciona
A full installation of Xcode.app 26.0 is required to compile this software.Homebrew está compilandomarsdawndesde el código fuente, como hace en una Mac con Intel. Instala Xcode 26 o posterior desde el App Store y vuelve a ejecutar la instalación.marsdawn: No such file: …La ruta no apunta a un archivo. Revisa el nombre o ejecuta el comando desde la carpeta donde está el archivo.… already exists. Pass --force to replace it.Ya existe un PDF con ese nombre. Agrega--forcepara reemplazarlo, u-opara escribirlo en otro lugar.Error: The value '…' is invalid for '--theme <theme>'.No reconoce el tema o el tamaño de papel. Los temas son dawn, classic, modern y vivid; el papel es a4 o letter.
Siguiente
- Todas las opciones y el JSON que imprime: Línea de comandos.
- Para que un agente de programación lo haga por ti, ejecuta
marsdawn skill --installpara agregar la skill de agente de marsdawn. - Los cuatro temas de vista previa y hacia dónde va la exportación a PDF: temas de vista previa y exportación a PDF.
- Entregar el PDF a alguien que no usa Markdown: compartir un PDF.