Para migrar la documentación a Markdown, entregue a un agente de IA la carpeta del archivo y haga que ejecute convert_to_markdown una vez por archivo, en lotes revisados. Con GroupDocs.Markdown.Mcp esto ocurre localmente en Claude Code, Cursor, GitHub Copilot u otro cliente MCP, de modo que un archivo de procedimientos internos nunca se sube a un servicio de conversión:

Convierta todo en la carpeta del archivo a Markdown con front matter e imágenes como archivos. Informe el formato de origen, el recuento de páginas y el tamaño de salida para cada uno.

La versión paso a paso con configuración y solución de problemas está en la documentación: How to migrate legacy documentation to Markdown with AI.

¿Por qué la migración de documentación heredada es un trabajo para un agente?

La conversión es mecánica y el trabajo circundante es repetitivo: enumerar los archivos, convertir cada uno, medir el resultado, encontrar los fallos, repetir. Una persona que hace eso para cientos de archivos toma la misma decisión cientos de veces. Un agente lo hace de forma consistente y reporta cada resultado, mientras que el motor, no el modelo, produce el Markdown. El Markdown guardado no es una paráfrasis de sus procedimientos.

Esto es un runbook. Cada paso tiene un prompt, y la tabla posterior separa lo que decide el agente de lo que hace el motor.

Runbook: ¿cómo migrar un archivo Word a Markdown?

  1. Verifique la licencia antes de cualquier otra cosa.

    Antes de convertir nada: ¿cuál es el estado de la licencia del servidor markdown?

    get_license_status devuelve mode, licensed, consumption y las versiones del servidor y del motor. El modo de evaluación procesa 3 páginas por documento, por lo que una ejecución sin licencia produce borradores plausibles.

  2. Inventariar el archivo.

    Enumere cada archivo en la carpeta del archivo con su formato, recuento de páginas y si está encriptado.

    El servidor Markdown no tiene herramienta de listado de carpetas, por lo que el agente enumera la carpeta con el acceso a archivos de su cliente o trabaja a partir de los nombres de archivo que usted le proporcione.

    Luego get_document_info devuelve fileFormat, pageCount, title, author e isEncrypted para cada archivo sin convertirlo. Los archivos encriptados necesitan el parámetro password.

  3. Ejecute un piloto de unas veinte archivos.

    Convierta los primeros veinte documentos a Markdown con front matter e imágenes como archivos. Informe formato, páginas y tamaño de salida para cada uno.

  4. Identifique lo que no se convirtió.

    Enumere los PDFs cuya conversión produjo menos de 2 KB de Markdown para más de 5 páginas.

    Eso casi siempre son escaneos. No hay paso de OCR en este servidor, por lo que necesitan otra herramienta o permanecen como PDFs indexados por metadatos.

  5. Corrija el patrón y luego ejecute el resto en lotes. Veinte archivos por ronda, con un informe cada vez, mantiene la ejecución revisable y el uso medido predecible.

  6. Revise la salida como lo haría con una pull request. Las siguientes secciones enumeran qué observar.

Decisión Agente Motor
Qué archivos convertir, en qué orden y tamaño de lote Sí No
Qué opciones pasar (images, frontMatter, flavor) Sí, según su prompt No
Convertir encabezados, listas y tablas a Markdown No Sí
Guardar los archivos .md e imágenes No Sí
Detectar un archivo de 300 páginas que quedó en 4 KB Sí, del informe No
Renombrar, estructura de carpetas, claves extra de front‑matter Sí No

¿Qué formatos migran bien?

  • DOCX, DOC, RTF, ODT. La estructura es explícita en el origen, por lo que encabezados y tablas se trasladan limpiamente.
  • EPUB y MOBI. La estructura de capítulos se mapea a encabezados de Markdown.
  • CHM. Archivos de ayuda antiguos, a menudo la única copia de un procedimiento.
  • XLSX. Las hojas de cálculo se convierten en tablas, lo que se adapta a listas de parámetros.

¿Qué debe comprobar la fase de revisión?

Pida al agente que haga la primera pasada, luego revise una muestra usted mismo:

Para cada archivo convertido, enumere las imágenes que referencia y dígame qué archivos de imagen faltan.

Muéstreme los cinco resultados con el tamaño más pequeño relativo a su recuento de páginas.

Las imágenes escritas con images: "file" se sitúan junto al .md y se referencian mediante ruta relativa, que es lo que espera un repositorio de docs. Un .md que apunta a imágenes que nunca se escribieron se renderiza con imágenes rotas. Luego abra la fuente más desordenada y su salida lado a lado antes de aplicar el patrón al resto. Confirme el resultado revisado con su flujo de trabajo git habitual; el servidor escribe los archivos y no toca su repositorio.

Sesión de ejemplo (abreviada)

You:   Convert the first twenty documents in /archive to Markdown with front matter
       and images as files. Report format, pages and output size for each.
Agent: convert_to_markdown (frontMatter: true, images: "file") x 20
       ops-manual-2014.docx   DOCX   88 pages   converted
       install-guide.chm      CHM    41 pages   converted
       supplier-forms-2009.pdf PDF   12 pages   1 KB of Markdown: probably a scan
       Nineteen files look consistent; one scan needs separate handling.

Límites honestos

Sin una licencia, el modo de evaluación procesa solo las primeras 3 páginas de cada documento, con una marca de agua de evaluación en cada una. Una ejecución de migración en ese estado genera cientos de archivos cortos que parecen correctos, y la brecha se descubre semanas después cuando alguien busca un procedimiento que falta. La migración necesita una licencia, así que ejecute get_license_status antes del primer lote. Los PDFs escaneados no se convierten.

FAQ

¿Puedo convertir cientos de documentos Word a Markdown de una sola vez?

Sí, pero no en un solo prompt. Convierta en lotes de unas veinte y lea el informe después de cada uno, de modo que una opción incorrecta se corrija antes de aplicarse a todo el archivo.

¿Cómo migro la documentación a git con un agente de IA?

El servidor escribe archivos .md y archivos de imagen en la carpeta de salida. Usted los revisa y los confirma con su flujo de trabajo git habitual.

¿La migración de docs‑as‑code sube mis documentos?

No. GroupDocs.Markdown.Mcp es un proceso local, y el archivo se lee desde el disco. Sólo lo que el agente escribe en la conversación llega al proveedor del modelo.

Profundice