Empieza por la opción más sencilla
Para convertir un archivo normal una sola vez, el navegador suele ser la opción más rápida: abre el documento, revisa el Markdown y descarga el resultado.
El Skill compensa la instalación cuando el agente ya está trabajando con tus archivos. Puede extraer un informe, corregir el Markdown, crear otro formato y comprobar el archivo final sin sacar el documento del flujo de trabajo.
| Situación | Punto de partida recomendado |
|---|---|
| Un archivo sencillo y una salida | Conversor en el navegador |
| Edición o vista previa rápida | Herramienta en el navegador |
| Conversiones repetidas dentro del agente | Agent Skill |
| PDF → Markdown → DOCX u otra salida | Agent Skill |
| Hay que verificar el archivo generado | Agent Skill |
| La maquetación original debe quedar idéntica | Revisión manual o flujo específico del formato |
Markdown funciona como capa de trabajo, no como copia visual
Markdown conserva bien la estructura que un agente puede editar: títulos, párrafos, listas, enlaces, código y muchas tablas sencillas. Por eso resulta útil entre el archivo de origen y la entrega final.
Ese paso intermedio también marca el límite. Un PowerPoint se convierte en contenido legible de las diapositivas, no en su diseño original. Si después generas otro PPTX, el archivo nuevo parte del Markdown y no recupera posiciones, animaciones, fuentes o elementos multimedia que se perdieron al extraer el contenido.
Usa este flujo cuando importa más el contenido que una reproducción píxel a píxel.
Instala Markdown Converter en tu agente
El repositorio usa el formato abierto Agent Skills y está pensado para Codex, Claude Code y clientes compatibles. Requiere Node.js 20 o una versión posterior e incluye el motor de conversión, OCR, modelos de idioma compatibles, fuentes y verificador.
Define MARKDOWN_CONVERTER_DIR como la carpeta instalada que contiene SKILL.md. No presupongas que el terminal está abierto dentro del repositorio del Skill.
npx skills add agent-tools-lab/markdown-converter --skill markdown-converternode "$MARKDOWN_CONVERTER_DIR/scripts/runtime/convert.mjs" INPUT --to FORMAT -o OUTPUTConvierte un PDF con capa de texto a Markdown
Si puedes seleccionar una frase en el lector de PDF, empieza con la extracción de texto. El resultado suele conservar párrafos, títulos y viñetas reconocibles, pero puede simplificar columnas, tablas complejas, fórmulas, notas al pie y posiciones de página.
Revisa el orden de lectura antes de reutilizar el Markdown, especialmente en documentos con varias columnas.
node "$MARKDOWN_CONVERTER_DIR/scripts/runtime/convert.mjs" informe.pdf --to markdown -o informe.mdinforme.md — borrador editable extraído de la capa de textoUsa OCR solo en páginas que sean imágenes
Un PDF escaneado puede parecer legible y no contener texto real. El Skill extrae el texto nativo cuando existe y aplica OCR únicamente a las páginas sin una capa de texto utilizable.
Los modelos incluidos cubren inglés, español, alemán, japonés y chino simplificado. El límite actual es de 30 MB, 100 páginas en total y 20 páginas procesadas con OCR por archivo.
El OCR produce un borrador, no una transcripción certificada. Comprueba nombres, fechas, importes, signos de puntuación, encabezados y tablas contra el escaneo.
node "$MARKDOWN_CONVERTER_DIR/scripts/runtime/convert.mjs" escaneo.pdf --to markdown --ocr-language spa -o escaneo.mdNombres · cifras · fechas · orden de lectura · tablas| Idioma OCR | Código |
|---|---|
| Inglés | eng |
| Español | spa |
| Alemán | deu |
| Japonés | jpn |
| Chino simplificado | chi_sim |
Pasa un DOCX a Markdown editable
Los documentos de Word centrados en texto son los mejores candidatos. Párrafos, títulos, listas, enlaces y tablas sencillas tienen equivalentes razonables en Markdown.
No cuentes con conservar la maquetación exacta, comentarios, control de cambios, macros, objetos flotantes, fuentes, espaciado ni contenido multimedia incrustado. Si el diseño de página es el activo principal, conserva y edita el DOCX original.
node "$MARKDOWN_CONVERTER_DIR/scripts/runtime/convert.mjs" informe.docx --to markdown -o informe.mdRevisar y editar la estructura del documento antes de volver a exportarGenera un PDF con texto real desde Markdown
El escritor de PDF crea un documento A4 nuevo con objetos de texto, no una captura de pantalla de cada página. Los caracteres compatibles se pueden buscar, seleccionar, copiar y extraer.
Si el flujo empezó con otro PDF, el diseño de aquel archivo no reaparece. El resultado refleja el Markdown revisado y el estilo del generador.
node "$MARKDOWN_CONVERTER_DIR/scripts/runtime/convert.mjs" notas.md --to pdf -o notas.pdfAbrir notas.pdf y seleccionar una frase representativaInterpreta correctamente la lista de formatos
Los archivos que no son Markdown se convierten primero en una representación Markdown editable. Cualquier segunda salida se genera desde esa representación, no directamente desde el documento original.
Algunos nombres necesitan contexto: JSON representa los tokens de Markdown, Confluence genera Wiki Markup heredado y Notion produce Markdown orientado a importación, no una operación de la API de Notion.
| Familia | Ejemplos | Límite principal |
|---|---|---|
| Entradas | PDF, DOCX, XLSX/XLS, PPTX, HTML, TXT, CSV, JSON, XML | El contenido pasa a Markdown; se puede perder diseño o comportamiento de la aplicación |
| Documentos | PDF, DOCX, XLSX, PPTX, EPUB | Son archivos nuevos generados desde Markdown |
| Publicación y texto | HTML, LaTeX, AsciiDoc, RTF, RST, Confluence, Notion, Reveal, WeChat | Cada destino tiene límites propios |
| Datos e imágenes | CSV, JSON de tokens, mapa mental, PNG, JPG, Card | La fuente debe tener una estructura adecuada; Card resume el contenido |
Verifica el archivo antes de dar la tarea por terminada
Un comando que termina sin error no demuestra que el documento sea útil. Ejecuta el verificador incluido y abre después el archivo en la aplicación donde se va a utilizar.
Si el verificador falla, la conversión también ha fallado. Conserva siempre el archivo de origen y escribe el resultado en otra ruta.
- Confirma que el archivo existe, no está vacío y se abre.
- Compara fragmentos representativos con el origen.
- Comprueba que el texto no inglés se muestra correctamente.
- En PDF, selecciona o extrae una frase real.
- En OCR, coteja nombres, números y un párrafo completo con la imagen.
python3 "$MARKDOWN_CONVERTER_DIR/scripts/verify_output.py" notas.pdf --format pdfComparar títulos, párrafos, listas, tablas, enlaces y caracteres no ASCIIProcesamiento local no significa conversión sin pérdidas
El Skill no añade logotipos, marcas de agua, pies promocionales, enlaces de atribución ni metadatos ocultos del producto a los archivos generados.
Aun así, Markdown no puede representar toda la maquetación, fórmulas de hoja de cálculo, comentarios, control de cambios, animaciones, notas del presentador, elementos multimedia o tablas complejas. Usa un flujo especializado cuando cualquiera de esos elementos sea imprescindible.
Herramientas relacionadas
Preguntas frecuentes
¿Puede Codex convertir un PDF a Markdown con este Skill?
Sí. Los PDF con texto usan extracción local. Las páginas que solo contienen imágenes pueden usar OCR local dentro de los límites de idioma, tamaño y páginas documentados.
¿Funciona también con Claude Code?
Sí. El repositorio usa el formato Agent Skills y está pensado para Codex, Claude Code y otros clientes compatibles.
¿Todos los PDF necesitan OCR?
No. Si el PDF tiene una capa de texto utilizable, debe extraerse directamente. El OCR se reserva para páginas que son imágenes.
¿Convierte Word, Excel y PowerPoint a Markdown?
Sí, admite DOCX, XLSX/XLS y PPTX como entradas. Conserva contenido legible y estructura básica, no el diseño completo de Office.
¿Puede volver a crear Word o PowerPoint desde Markdown?
Sí, DOCX y PPTX son salidas admitidas. Son documentos nuevos generados desde Markdown, no reconstrucciones exactas del archivo original.
¿El PDF generado permite buscar texto?
Sí, para los caracteres compatibles. El escritor crea texto real y el verificador comprueba que exista una capa de texto extraíble.
¿Cuándo conviene usar ilovemd.net?
Para una conversión, edición o vista previa puntual en el navegador. Usa el Skill cuando la conversión forme parte de un proceso repetido o de varios pasos dentro del agente.
¿Dónde se instala Markdown Converter?
Desde https://github.com/agent-tools-lab/markdown-converter, con el comando npx skills add agent-tools-lab/markdown-converter --skill markdown-converter.