Cómo convertir Markdown a PDF en VS Code
Exporta Markdown a PDF desde el editor o la vista previa de VS Code. Si necesitas texto seleccionable, también puedes imprimir desde el navegador.
La vista previa de Markdown que incluye VS Code no tiene un comando para exportar a PDF. Con una extensión puedes hacerlo desde el editor o desde la propia vista previa. Si solo necesitas convertir un archivo, también puedes abrirlo en un conversor en el navegador.
A. Exportar desde el editor con Markdown PDF
- Busca
yzane.markdown-pdfen la vista de extensiones de VS Code e instala Markdown PDF. - Abre el archivo
.mdy pulsaF1oCtrl+Shift+P(⌘⇧Pen Mac) para abrir la paleta de comandos. - Escribe
exporty seleccionamarkdown-pdf: Export (pdf). Al hacer clic derecho dentro del editor verás las mismas opciones de exportación, incluidashtml,png,jpegyall.
La extensión usa Puppeteer para generar las páginas con Chromium. Primero usa el navegador indicado en markdown-pdf.executablePath. Si no has indicado ninguno, busca una instalación de Chrome, Edge o Chromium. Si no encuentra ninguna, descarga Chromium la primera vez. Puedes desactivar la descarga automática con markdown-pdf.chromium.autoDownload en false.
El tamaño de papel predeterminado es A4. Para preparar un documento en tamaño carta con márgenes de 1,5 cm, añade estos ajustes a settings.json.
{
"markdown-pdf.format": "Letter",
"markdown-pdf.margin.top": "1.5cm",
"markdown-pdf.margin.bottom": "1.5cm",
"markdown-pdf.margin.left": "1.5cm",
"markdown-pdf.margin.right": "1.5cm"
}
Activa markdown-pdf.displayHeaderFooter para mostrar el encabezado y el pie de página. Su contenido se define en markdown-pdf.headerTemplate y markdown-pdf.footerTemplate, respectivamente. Usa markdown-pdf.outputDirectory para elegir la carpeta de destino y markdown-pdf.styles para aplicar tu CSS. Las versiones recientes filtran por defecto el HTML que escribes directamente en el documento.
B. Exportar desde la vista previa con Markdown Preview Enhanced
- Instala Chrome y la extensión Markdown Preview Enhanced (
shd101wyy.markdown-preview-enhanced). - Abre el archivo Markdown y ejecuta
Markdown Preview Enhanced: Open Preview. Para abrir la vista previa a un lado, pulsaCtrl+K V(⌘K Ven Mac). - Haz clic derecho dentro de la vista previa, elige
Chrome (Puppeteer)y selecciona la exportación a PDF.
Para que este documento se imprima en A4 vertical, coloca este bloque de metadatos YAML al principio del archivo Markdown.
---
puppeteer:
landscape: false
format: "A4"
---
C. Convertir en el navegador sin extensiones
Abre el conversor de Markdown a PDF de ConverterTo, selecciona el archivo y elige A4 o carta. La conversión se realiza en tu navegador. Tienes dos opciones según el uso que vayas a darle al PDF.
- Crear PDF basado en imágenes genera un archivo descargable con los saltos de página entre líneas. Cada página es una imagen y el texto no se puede seleccionar.
- Imprimir en PDF (texto seleccionable) abre el cuadro de impresión del navegador. Guarda el documento como PDF desde ahí si quieres que el lector pueda copiar un párrafo.
¿Qué método conviene?
| Característica | Markdown PDF | Markdown Preview Enhanced | ConverterTo |
|---|---|---|---|
| Preparación | Extensión y navegador basado en Chromium | Extensión y Chrome | Abrir el conversor en el navegador |
| Texto seleccionable | Generalmente sí | Generalmente sí | Al imprimir en PDF |
| CSS personalizado | markdown-pdf.styles | Estilos de la vista previa | Estilos integrados |
| Uso sin conexión tras la instalación | Suele funcionar con recursos locales | Suele funcionar con recursos locales | Hace falta conexión para cargar el conversor y las imágenes remotas |
| Imágenes con rutas relativas | Suelen funcionar si los archivos están en su sitio | Suelen funcionar si los archivos están en su sitio | Usa direcciones URL absolutas |
| Cuándo elegirlo | Para reutilizar ajustes de exportación | Para exportar la vista previa mientras escribes | Para una conversión puntual |
Solución de problemas
- El proxy bloquea la descarga de Chromium. Configura
http.proxyen VS Code o indica la ruta a un navegador instalado enmarkdown-pdf.executablePath. - Falta una imagen. Si el enlace apunta a
images/chart.png, comprueba la ruta desde la carpeta del Markdown. El conversor del navegador solo recibe el archivo que seleccionas y no puede resolver esas rutas. Usa una URL absoluta para la imagen. Las imágenes remotas se cargan desde el servidor que las aloja, que puede ver tu dirección IP. - Los caracteres chinos, japoneses o coreanos aparecen como cuadrados. Comprueba que el equipo donde exportas tenga instalada una fuente que incluya esos caracteres.
- Quieres que una sección empiece en otra página. En Markdown PDF, inserta
<div class="page"></div>en una línea aparte antes del título de la sección.
Preguntas frecuentes
¿Puedo exportar al guardar? En Markdown PDF, activa markdown-pdf.convertOnSave y reinicia VS Code. Para Markdown Preview Enhanced, añade export_on_save: { puppeteer: true } en el nivel superior del bloque YAML inicial.
¿Y si necesito una página web o un documento editable? Usa Markdown a HTML para crear una página web o Markdown a Word para entregar una copia que se pueda editar.