Para publicar documentos como un sitio estático, pide a un agente de IA que los convierta a Markdown con front matter en YAML y que las imágenes se guarden como archivos, luego ejecuta tu generador. GroupDocs.Markdown.Mcp realiza la conversión localmente, por lo que Claude Desktop, Claude Code, Cursor o GitHub Copilot pueden preparar contenido de Word, Excel y libros electrónicos para Hugo, Jekyll, MkDocs o Docusaurus sin enviarlo a un servicio:

Convertir estos documentos a Markdown con front matter, sabor de GitHub y imágenes guardadas como archivos.

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo publicar documentos en un sitio estático como Markdown.

¿Qué necesita un generador de sitios estáticos de un documento?

Tres cosas: Markdown para el cuerpo, front matter en YAML para los metadatos y imágenes como archivos en rutas relativas. Hugo, Jekyll, MkDocs y Docusaurus leen front matter. convert_to_markdown produce los tres cuando eliges las opciones para él:

Opción Valor para un sitio Qué hace
frontMatter true Escribe YAML con título, autor, formato y recuento de páginas al inicio del archivo
images "file" Escribe imágenes junto al .md y las referencia mediante ruta relativa
flavor "github" (default), or "commonmark" El Markdown con sabor de GitHub es lo que la mayoría de los generadores asumen; CommonMark se adapta a una cadena de herramientas más estricta

Verifica el título y el autor al inicio de cada archivo convertido; si están vacíos o son incorrectos, pide al agente que los establezca.

¿Cómo convierto Word a Markdown para Hugo?

Hugo es el generador detrás de este blog, así que es el ejemplo aquí. El flujo tiene cuatro pasos, y el agente ejecuta todos ellos.

  1. Convertir. Ejecuta el mensaje anterior en la carpeta de documentos.
  2. Organizar. El servidor escribe los archivos; el diseño es trabajo del agente.

    Coloca cada archivo convertido en una carpeta con el nombre del documento, con sus imágenes en una subcarpeta images al lado.

  3. Añadir las claves que requiere el tema. Los temas de Hugo a menudo esperan date o weight. La herramienta no los escribe, así que pide:

    Añade weight al front matter de cada archivo, numerado en el orden en que los enumeré.

  4. Construir. Ejecuta Hugo tú mismo. En este punto los archivos son Markdown ordinario con front matter, y el generador los trata como cualquier página.

Para Docusaurus y MkDocs se aplica la misma salida; solo difieren la estructura de carpetas y las claves adicionales, y las describes en el segundo y tercer mensaje.

Sesión de ejemplo (abreviada)

You:   Convert the three documents in /drafts to Markdown with front matter, GitHub
       flavour, and images as files. One folder per document.
Agent: convert_to_markdown (frontMatter: true, flavor: "github", images: "file") x 3
       Created guide-onboarding/, guide-security/, price-list/ with .md files and
       images subfolders. Front matter holds title, author, format and page count.
You:   Add weight to each file in the order I listed them.
Agent: Updated the front matter of the three files with weight 10, 20 and 30.

¿Cómo verifico el resultado antes de publicar?

Dos verificaciones detectan casi todos los problemas:

Para cada archivo convertido, compara el recuento de páginas del origen con la longitud del Markdown.

Un documento de 60 páginas que se convirtió en 3 KB de Markdown es un PDF escaneado o una ejecución en modo de evaluación.

Enumera la carpeta de imágenes de cada documento y las imágenes que su Markdown referencia.

Un .md que referencia imágenes nunca escritas se muestra con imágenes rotas en el sitio. Haz una verificación puntual del origen más desordenado antes de un lote de doscientos.

Los orígenes de Word y Excel se convierten con su estructura intacta: los encabezados se convierten en encabezados y las tablas en tablas Markdown. Los PDFs dependen de cómo fueron creados. Una exportación nativa digital se convierte limpiamente; un escaneo no se convierte de manera útil, porque este servidor no tiene paso de OCR.

¿Qué claves de front matter añado yo mismo?

frontMatter: true escribe título, autor, formato y recuento de páginas. Verifica esos valores en cada archivo y pide al agente que corrija los que estén vacíos o incorrectos. Navegación, orden, etiquetas y fechas son claves que añades después de la conversión, como en el paso 3. Para extraer propiedades de documento más ricas al front matter, combina este servidor con GroupDocs.Metadata.Mcp, que las lee, y haz que el agente añada las claves; este artículo no cubre eso.

Limitaciones honestas

Sin una licencia, el servidor funciona en modo de evaluación, y solo se procesan las primeras 3 páginas, con una marca de agua de evaluación en cada una. Un sitio construido con salida sin licencia entrega fragmentos de tres páginas de documentos extensos. Ejecuta get_license_status antes de convertir y mantén la verificación de “longitud contra origen” en el bucle.

Preguntas frecuentes

¿Cómo convierto Word a Markdown para Hugo?

Pide al agente que convierta el documento con frontMatter: true, images: "file" y flavor: "github", y luego que organice los archivos en tu carpeta de contenido. Añade cualquier clave específica del tema, como weight, en un segundo mensaje.

¿Puede un agente de IA publicar documentos en un sitio estático?

Puede preparar todo lo que la compilación del sitio necesita: Markdown, front matter, archivos de imágenes y estructura de carpetas. Tú ejecutas el generador, por lo que la compilación y el despliegue permanecen bajo tu control.

¿La conversión ocurre localmente?

Sí. GroupDocs.Markdown.Mcp se ejecuta como un proceso local sobre stdio y lee los documentos de la carpeta que configuraste. Los documentos que se hacen públicos solo después de la revisión permanecen en tu máquina hasta que los publiques.

Profundiza