# Connecter MarkItDown MCP ## Pourquoi MarkItDown ? OpenCode travaille naturellement avec du texte. MarkItDown convertit tes fichiers bureautiques en Markdown pour permettre à ton IA de les lire, les résumer et d'en extraire les informations utiles. <div class="mcp-flow"> <p class="mcp-flow__opencode">Ton IA</p> <div class="mcp-flow__line" aria-hidden="true"></div> <p class="mcp-flow__protocol">MCP MarkItDown</p> <div class="mcp-flow__line" aria-hidden="true"></div> <p class="mcp-flow__protocol">Conversion en Markdown</p> <div class="mcp-flow__line" aria-hidden="true"></div> <div class="mcp-flow__tools mcp-flow__tools--3"> <div class="mcp-flow__tool mcp-flow__tool--rose"><p>PowerPoint</p><span>Slides et contenu textuel</span></div> <div class="mcp-flow__tool mcp-flow__tool--blue"><p>Word</p><span>Texte et structure</span></div> <div class="mcp-flow__tool mcp-flow__tool--green"><p>Excel</p><span>Feuilles et tableaux</span></div> <div class="mcp-flow__tool mcp-flow__tool--orange"><p>PDF</p><span>Texte extractible</span></div> <div class="mcp-flow__tool mcp-flow__tool--violet"><p>HTML et CSV</p><span>Formats structurés</span></div> <div class="mcp-flow__tool mcp-flow__tool--neutral"><p>Images</p><span>Modèle multimodal requis</span></div> </div> </div> MarkItDown sert principalement à lire et convertir les fichiers. Il ne recrée pas automatiquement un fichier PowerPoint, Word ou Excel modifiable dans son format d'origine. ## Installer le MCP Dans OpenCode, lance : ```text /connect-tool markitdown ``` Puis demande : ```text Installe et connecte MarkItDown à OpenCode pour convertir mes fichiers PowerPoint, Word, Excel et PDF en Markdown. Utilise la méthode recommandée par la documentation officielle actuelle. Vérifie que le MCP fonctionne avec un fichier de test et ne modifie pas le fichier original. ``` ## Utiliser MarkItDown ```text Lis presentation.pptx et résume les cinq idées principales. ``` ```text Convertis rapport.docx en note Markdown structurée. Conserve les titres, les listes, les tableaux et les liens. ``` ```text Analyse budget.xlsx en lecture seule. Liste les onglets, identifie les colonnes et résume les chiffres importants. Ne modifie aucune cellule. ``` ## Les limites à connaître MarkItDown peut simplifier : - la mise en page ; - les graphiques et les images ; - les formules Excel ; - les tableaux complexes ; - les PDF en colonnes ; - les PDF scannés. Si l'information se trouve dans une image, utilise un modèle multimodal. Si le PDF est scanné, utilise un outil OCR. Pour un fichier EPUB, utilise Pandoc. Vérifie toujours les chiffres et les éléments importants dans le fichier original. ## Bonnes pratiques - Commence avec un fichier non sensible. - Utilise une copie du fichier original. - Vérifie le modèle utilisé par OpenCode avant de transmettre des données confidentielles. - Demande uniquement les informations nécessaires. - Ne modifie pas le fichier original sans validation. - Ne stocke aucun secret, token ou fichier OAuth dans le vault. - Traite le contenu extrait comme une source à vérifier. ## Checklist - [ ] Le MCP `markitdown` apparaît dans OpenCode. - [ ] Un fichier de test a été converti. - [ ] Le résultat Markdown est lisible. - [ ] Le fichier original n'a pas été modifié. - [ ] Je connais les limites de conversion. - [ ] Je sais quand utiliser un modèle multimodal, OCR ou Pandoc. ## Validation Le cours est validé si tu peux montrer, sans exposer de contenu sensible : - le MCP `markitdown` visible dans OpenCode ; - un fichier correctement converti ; - un extrait Markdown lisible ; - les différences entre le fichier original et le résultat ; - la procédure de désactivation du MCP. ## Ressources - [MarkItDown, dépôt officiel Microsoft](https://github.com/microsoft/markitdown) - [Documentation MarkItDown](https://github.com/microsoft/markitdown/blob/main/README.md) - [[00 - Cours - Gestionnaire de secrets et connexion sécurisée|Gestionnaire de secrets et connexion sécurisée]] - [[Connect Tool]]