folio.md
Guía imágenes PDF → .md + images/

PDF a Markdown con imágenes — Guía 2026

Los PDFs contienen imágenes: fotos, diagramas, capturas, logos, gráficos. Cuando conviertes un PDF a Markdown, la mayoría de herramientas simplemente eliminan las imágenes o las convierten en bloques de texto base64 ilegibles. Esta guía te muestra cómo conservar cada imagen como archivo independiente con rutas relativas que funcionan en cualquier editor.

El problema con las imágenes en PDF a Markdown

Un PDF típico combina texto e imágenes en un único archivo binario. Al convertirlo a Markdown, las imágenes necesitan salir del PDF y convertirse en archivos independientes. La mayoría de conversores hacen una de estas tres cosas (ninguna buena):

  • Eliminar las imágenes: el resultado es solo texto. Pierdes gráficos, diagramas, fotos.
  • Incrustar como base64: convierte cada imagen en un bloque de texto de miles de caracteres. El archivo Markdown pesa 10 veces más y es ilegible.
  • Usar rutas absolutas o URL temporales: los enlaces se rompen al mover el archivo o caducan en horas.

La solución correcta: extraer cada imagen como un archivo PNG o JPG independiente, guardarlo en una carpeta images/, y usar rutas relativas ![](images/figura1.png) en el Markdown.

Paso 1: Convierte el PDF con un conversor que extraiga imágenes

Sube tu PDF a un conversor que detecte y extraiga las imágenes como archivos separados. FolioMD hace esto automáticamente: analiza el PDF, identifica cada imagen (fotos, diagramas, gráficos, capturas), y las guarda en una carpeta images/.

Lo importante es que el conversor:

  • Detecte imágenes embebidas en el PDF (no solo páginas completas)
  • Extraiga cada imagen como archivo independiente (PNG para diagramas, JPG para fotos)
  • Genere rutas relativas en el Markdown
  • Empaquete todo en un ZIP para fácil descarga

Los conversores gratuitos como pdf2md o Pandoc con --extract-media generan rutas absolutas o nombres cripticos que no funcionan sin reconfiguración manual.

Paso 2: Descarga y descomprime el resultado

La conversión genera un ZIP con esta estructura:

mi-documento/
├── informe-2026.md           ← el Markdown
└── images/                   ← carpeta de imágenes
    ├── figura1.png           ← diagrama extraído
    ├── foto-equipo.jpg       ← foto extraída
    ├── grafico-ventas.png    ← gráfico extraído
    └── ...

Descomprime el ZIP en cualquier carpeta. El archivo .md y la carpeta images/ deben quedar al mismo nivel. No renombres la carpeta images/ sin actualizar también los enlaces dentro del Markdown.

Verifica que el Markdown contiene rutas relativas, no absolutas ni base64:

✓ Correcto:  ![](images/figura1.png)
✗ Base64:    ![](data:image/png;base64,iVBORw0KGgo...)
✗ Absoluta:  ![](/home/user/documentos/images/figura1.png)
✗ URL:       ![](https://cdn.temp.io/abc123.png)

Paso 3: Verifica que las imágenes se muestran correctamente

Abre el archivo .md en tu editor o herramienta preferida:

  • Obsidian: coloca .md y images/ en tu vault y abre el archivo. Las imágenes aparecen en vista lectura.
  • VS Code: con la extensión Markdown Preview, las imágenes se renderizan si la carpeta images/ está al mismo nivel.
  • GitHub: sube .md y images/ al repositorio y el README renderizará las imágenes.
  • Si no se ve una imagen: revisa que el archivo existe en images/ y que la ruta en el Markdown coincide exactamente (mayúsculas/minúsculas incluidas).

Consejo: si planeas editar el Markdown, mantén la carpeta images/ siempre junto al archivo .md. Si los separas, los enlaces se romperán.

Rutas relativas vs. absolutas vs. base64

La diferencia entre los tres tipos de imágenes en Markdown es crítica:

Tipo de ruta Ejemplo ¿Funciona offline? ¿Portable? ¿Legible?
Relativa ![](images/fig.png)
Absoluta ![](/home/user/img/fig.png) No
Base64 ![](data:image/png;base64...) No
URL externa ![](https://cdn.io/fig.png) No No

Solo las rutas relativas cumplen los tres requisitos: funcionan sin internet, son portables (mueves la carpeta y siguen funcionando), y no bloquean el editor con miles de caracteres de base64.

Formatos de imagen: PNG, JPG, SVG

Al convertir PDF a Markdown con imágenes, el formato del archivo matters:

  • PNG: formato lossless. Ideal para diagramas, capturas de pantalla, texto dentro de imágenes, y cualquier gráfico con bordes nítidos. Archivos más pesados pero sin pérdida de calidad.
  • JPG: formato lossy. Mejor para fotografías y imágenes con degradados. Archivos más ligeros. No recomendado para diagramas con texto (se ve borroso).
  • SVG: formato vectorial. Ideal si el PDF contiene diagramas vectoriales. Infinitamente escalable sin pérdida. No todos los conversores lo generan.

FolioMD elige automáticamente PNG para diagramas y capturas, y JPG para fotografías, optimizando calidad y peso. Si el PDF contiene elementos vectoriales, se preservan como PNG de alta resolución.

Comparativa de herramientas que extraen imágenes

Herramienta Imágenes extraídas Rutas relativas Sin base64 Precio
FolioMD PNG/JPG Gratis + Prioridad 5 €
Mathpix Parcial Parcial De pago
Pandoc --extract-media Original No Gratis (CLI)
pdf2md / LightPDF No No No (base64) Gratis
Marker (Python) PNG Parcial Gratis (local)

La mayoría de conversores gratuitos online eliminan las imágenes o las incrustan como base64. Pandoc extrae las imágenes pero genera rutas absolutas que no funcionan sin ajustes manuales. FolioMD es el único que genera rutas relativas limpias en un ZIP listo para usar.

Convierte tu PDF a Markdown con imágenes

Gratis ilimitado. Imágenes extraídas como archivos PNG/JPG con rutas relativas. Funciona en Obsidian, VS Code, GitHub y cualquier editor Markdown.

convertir PDF ahora → cómo funciona →