md-to-docx : conversion Markdown vers Word
Ce skill fait partie du repository communautaire github/awesome-copilot, une collection de skills, agents, instructions et workflows destinés à enrichir l'expérience GitHub Copilot. Il se présente comme un dossier autonome (skills/md-to-docx/) contenant ce fichier SKILL.md d'instructions ainsi qu'un script Node.js prêt à l'emploi.
Ce que fait ce skill
L'objectif est de permettre à GitHub Copilot (ou à l'utilisateur directement) de transformer un fichier .md en document Word (.docx) correctement mis en forme, sans recourir à des outils externes comme Pandoc ou LibreOffice. La conversion repose sur deux packages npm — docx et marked — et s'exécute via un script md-to-docx.mjs inclus dans le dossier scripts/.
Le script prend en charge un ensemble complet d'éléments Markdown : titres, paragraphes, tableaux, blocs de code, listes, liens, règles horizontales et images PNG référencées localement. Il génère également une page de titre à partir du front-matter YAML du fichier source, ainsi qu'une table des matières basée sur les titres H1 à H3. Les images PNG sont lues, redimensionnées et embarquées directement dans le document produit.
Comment l'utiliser
Pour employer ce skill, il suffit de copier le dossier skills/md-to-docx/ dans son workspace, d'installer les dépendances Node.js une seule fois depuis le sous-dossier scripts/, puis d'invoquer le script en ligne de commande en précisant le fichier Markdown source et, optionnellement, le nom du fichier .docx de sortie. Node.js 18 ou supérieur est nécessaire ; aucune installation système supplémentaire n'est requise, ce qui le rend compatible Windows, macOS et Linux.
Dans le contexte de GitHub Copilot, ce skill peut être référencé dans un agent ou un workflow pour automatiser la génération de documents Word à partir de documentation Markdown existante, par exemple pour produire des livrables techniques destinés à des parties prenantes non techniques.