Images

Hébergement et intégration d'images dans vos pages Markdown

Présentation

Markdodo propose deux méthodes pour intégrer des images dans vos pages Markdown. Vous pouvez utiliser un lien externe pointant vers une image hébergée ailleurs, ou bien envoyer directement un fichier image qui sera stocké sur votre espace Markdodo. Dans les deux cas, l'intégration dans le contenu se fait en Markdown avec la syntaxe classique ou la syntaxe miniature.

Important : Le contenu des pages est en Markdown uniquement. L'utilisation de balises HTML pour les images n'est pas prise en charge.

Syntaxes disponibles

Image classique

![Texte alternatif](https://example.com/image.jpg)

Affiche l'image en taille normale.

Miniature forcée

!![Texte alternatif](https://example.com/image.jpg)

Force l'affichage de l'image sous forme de miniature.

Les deux syntaxes fonctionnent également avec les images hébergées sur Markdodo :

![Texte alternatif](slug-de-mon-image)
!![Texte alternatif](slug-de-mon-image)

Méthode 1 - Image par URL externe

La méthode la plus simple consiste à utiliser une URL externe pointant vers une image déjà hébergée.

![Logo Markdodo](https://markdodo.com/public/images/markdodo/logo.png)

Pour forcer l'affichage en miniature :

!![Logo Markdodo](https://markdodo.com/public/images/markdodo/logo.png)

Méthode 2 - Hébergement sur Markdodo via API

Envoyer une image par URL (POST /api/images/formData)

Malgré son nom historique, cet endpoint attend désormais une URL publique d'image dans un body JSON.

curl -s -X POST "https://markdodo.com/api/images/formData" \
  -H "Authorization: Bearer votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/mon-image.jpg",
    "slug_image": "mon-image",
    "alt_image": "Description de mon image",
    "max_size": 1200
  }'
Paramètre Type Obligatoire Description
image_url string Oui URL publique de l'image à télécharger
slug_image string Oui Slug unique identifiant l'image
alt_image string Non Texte alternatif
max_size integer Non Taille maximale

Envoyer une image en base64 (POST /api/images/base64)

curl -s -X POST "https://markdodo.com/api/images/base64" \
  -H "Authorization: Bearer votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "data:image/png;base64,iVBORw0KGgo...",
    "slug_image": "mon-image-generee",
    "alt_image": "Image générée par IA",
    "max_size": 1200
  }'
Paramètre Type Obligatoire Description
image string Oui Image en base64
slug_image string Oui Slug unique
alt_image string Oui Texte alternatif
max_size integer Non Taille maximale

Utiliser une image stockée

![Texte alternatif](slug-de-mon-image)

Pour forcer l'affichage en miniature :

!![Texte alternatif](slug-de-mon-image)

Bonnes pratiques