Pour publier des documents sous forme de site statique, demandez à un agent IA de les convertir en Markdown avec un front matter YAML et des images enregistrées en fichiers, puis exécutez votre générateur. GroupDocs.Markdown.Mcp effectue la conversion localement, ainsi Claude Desktop, Claude Code, Cursor ou GitHub Copilot peuvent préparer le contenu Word, Excel et e‑book pour Hugo, Jekyll, MkDocs ou Docusaurus sans l’envoyer à un service :

Convertir ces documents en Markdown avec front matter, saveur GitHub, et images enregistrées en fichiers.

La version étape par étape avec configuration et dépannage se trouve dans la documentation : How to publish documents to a static site as Markdown.

De quoi un générateur de site statique a‑t‑il besoin à partir d’un document ?

Trois éléments : du Markdown pour le corps, du front matter YAML pour les métadonnées, et des images sous forme de fichiers avec des chemins relatifs. Hugo, Jekyll, MkDocs et Docusaurus lisent tous le front matter. convert_to_markdown produit les trois lorsqu’on sélectionne les options correspondantes :

Option Valeur pour un site Ce qu’elle fait
frontMatter true Écrit du YAML avec le titre, l’auteur, le format et le nombre de pages en haut du fichier
images "file" Écrit les images à côté du .md et les référence par un chemin relatif
flavor "github" (default), or "commonmark" Le Markdown à la saveur GitHub est ce que la plupart des générateurs supposent ; CommonMark convient à une chaîne d’outils plus stricte

Vérifiez le titre et l’auteur en haut de chaque fichier converti ; s’ils sont vides ou incorrects, demandez à l’agent de les définir.

Comment convertir Word en Markdown pour Hugo ?

Hugo est le générateur derrière ce blog, il constitue donc l’exemple ici. Le processus comporte quatre étapes, et l’agent les exécute toutes.

  1. Convertir. Exécutez l’invite ci‑dessus sur le dossier contenant les documents.
  2. Organiser. Le serveur écrit les fichiers ; la mise en page est la tâche de l’agent.

    Placez chaque fichier converti dans un dossier portant le nom du document, avec ses images dans un sous‑dossier images à côté.

  3. Ajouter les clés attendues par le thème. Les thèmes Hugo attendent souvent date ou weight. L’outil ne les écrit pas, donc demandez :

    Ajoutez weight au front matter de chaque fichier, numéroté dans l’ordre que j’ai indiqué.

  4. Construire. Exécutez Hugo vous‑même. À ce stade, les fichiers sont du Markdown ordinaire avec front matter, et le générateur les traite comme n’importe quelle page.

Pour Docusaurus et MkDocs, le même résultat s’applique ; seul le agencement des dossiers et les clés supplémentaires diffèrent, et vous les décrivez dans les deuxième et troisième invites.

Exemple de session (abrégé)

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.

Comment vérifier le résultat avant de publier ?

Deux vérifications permettent de détecter presque tous les problèmes :

Pour chaque fichier converti, comparez le nombre de pages de la source avec la longueur du Markdown.

Un document de 60 pages qui ne fait que 3 KB de Markdown est un PDF numérisé ou une exécution en mode évaluation.

Listez le dossier d’images de chaque document et les images référencées par son Markdown.

Un .md qui référence des images jamais écrites s’affiche comme des images cassées sur le site. Faites un contrôle ponctuel de la source la plus désordonnée avant un lot de deux cents.

Les sources Word et Excel se convertissent avec leur structure intacte : les titres restent des titres et les tableaux deviennent des tableaux Markdown. Les PDF dépendent de leur mode de création. Une exportation née‑numérique se convertit proprement ; une numérisation ne se convertit pas de façon utile, car ce serveur n’a aucune étape OCR.

Quelles clés de front matter dois‑je ajouter moi‑même ?

frontMatter: true écrit le titre, l’auteur, le format et le nombre de pages. Vérifiez ces valeurs dans chaque fichier et demandez à l’agent de corriger celles qui sont vides ou incorrectes. La navigation, l’ordre, les tags et les dates sont des clés que vous ajoutez après la conversion, comme à l’étape 3. Pour extraire des propriétés de document plus riches dans le front matter, associez ce serveur à GroupDocs.Metadata.Mcp, qui les lit, et faites ajouter les clés par l’agent ; cet article ne couvre pas cela.

Limites honnêtes

Sans licence, le serveur fonctionne en mode évaluation, et seules les trois premières pages sont traitées, avec un filigrane d’évaluation sur chacune. Un site construit à partir d’une sortie non licenciée ne comporte que des extraits de trois pages de documents longs. Exécutez get_license_status avant de convertir, et conservez la vérification « longueur par rapport à la source » dans la boucle.

FAQ

Comment convertir Word en Markdown pour Hugo ?

Demandez à l’agent de convertir le document avec frontMatter: true, images: "file" et flavor: "github", puis d’organiser les fichiers dans votre dossier de contenu. Ajoutez les clés spécifiques au thème, comme weight, dans une seconde invite.

Un agent IA peut‑il publier des documents sur un site statique ?

Il peut préparer tout ce dont la construction du site a besoin : Markdown, front matter, fichiers d’images et organisation des dossiers. Vous exécutez le générateur, ainsi la construction et le déploiement restent sous votre contrôle.

La conversion se fait‑elle localement ?

Oui. GroupDocs.Markdown.Mcp s’exécute comme un processus local via stdio et lit les documents depuis le dossier que vous avez configuré. Les documents qui ne deviennent publics qu’après révision restent sur votre machine jusqu’à leur publication.

Approfondir