Documentation Markdodo

API REST, serveur MCP et publication de sites Markdown


Présentation

Markdodo permet de créer, organiser et publier des pages Markdown, puis de les administrer avec l’API REST ou un agent compatible MCP.

Le projet prend actuellement en charge :


Sommaire


Base URL REST

https://markdodo.com/api

L’API REST utilise le header :

Authorization: Bearer <votre_cle_api>

Les clés sont liées à un site précis.


Ressources REST principales

Ressource Opérations
/api/pages Lister, créer, modifier et supprimer des pages
/api/pages/markdown/[slug] Lire le Markdown brut d’une page
/api/consignes Gérer les consignes privées
/api/consignes/markdown/[slug] Lire le Markdown brut d’une consigne
/api/images/formData Importer une image depuis une URL
/api/images/base64 Importer une image en base64
/api/files Lister ou supprimer des fichiers
/api/files/url Importer un fichier depuis une URL
/api/files/base64 Importer un fichier en base64

Consultez Endpoints REST pour les méthodes et paramètres.


Serveur MCP 1.2.0

Le lien MCP propre au site est disponible dans l’espace membre. L’outil get_rules fournit aux agents la documentation fonctionnelle à jour, notamment les syntaxes étendues, les blocs, les fichiers et les consignes.

Avant toute rédaction ou modification, un agent doit :

  1. appeler get_rules ;
  2. appeler list_consignes ;
  3. lire toutes les consignes disponibles ;
  4. lire le Markdown actuel de la page cible ;
  5. envoyer le document complet final.

Voir Serveur MCP.


Règles fondamentales