Référence des blocs

Une page est un titre plus une liste de blocs. Il y a 8 types de blocs.

Votre IA envoie les blocs en JSON via le serveur MCP. Cette page montre ce que prend chaque bloc.

Le titre est le H1

title est un champ de la page. Ce n'est pas un bloc.
C'est l'unique H1 de la page.
Une page a exactement un H1. Il n'y a donc pas de bloc H1.
Les blocs commencent à H2 (voir heading).

Texte riche en Markdown

Certains champs sont du texte riche. Ils acceptent uniquement le Markdown en ligne :

Vous écrivez	Vous obtenez
`gras`	gras
`italique`	italique
`code`	`code`
`[Flocon AI](https://flocon-ai.com)`	un lien

Interdit dans le texte riche :

Le HTML brut. Il n'est jamais stocké.
Les titres, les listes et les images. Utilisez des blocs pour ça.

Champs en texte riche : content de description et text, items de list, answer de faq.

Champs en texte simple (pas de Markdown) : content de heading, headers et rows de table.

description

L'intro qui répond d'abord. Mettez-la en premier. Les moteurs de recherche IA la citent souvent.

content : texte riche.

{
  "type": "description",
  "content": "Notion coûte **10 $ par utilisateur et par mois**. Obsidian est gratuit en usage personnel."
}

text

Un paragraphe.

content : texte riche.

{
  "type": "text",
  "content": "Obsidian stocke les notes en fichiers `.md` locaux. Lisez la [doc](https://help.obsidian.md)."
}

heading

Un titre de section.

level : 2 ou 3.
content : texte simple.

{ "type": "heading", "level": 2, "content": "Tarifs" }

list

Une liste à puces ou numérotée.

ordered : true pour des numéros, false pour des puces.
items : une liste de textes riches.

{
  "type": "list",
  "ordered": true,
  "items": ["Exportez vos notes", "Importez-les dans **Obsidian**", "Vérifiez vos liens"]
}

faq

Des questions et des réponses. Flocon AI génère aussi le JSON-LD FAQPage à partir de ces blocs. Vous n'avez rien à faire.

items : une liste de question (texte simple) et answer (texte riche).

{
  "type": "faq",
  "items": [
    {
      "question": "Obsidian est-il gratuit ?",
      "answer": "Oui, en usage personnel. Voir la [page des tarifs](https://obsidian.md/pricing)."
    }
  ]
}

table

Un tableau. Idéal pour les comparaisons.

headers : liste optionnelle de textes simples.
rows : une liste de lignes. Chaque ligne est une liste de cellules en texte simple.

{
  "type": "table",
  "headers": ["", "Notion", "Obsidian"],
  "rows": [
    ["Prix", "10 $ / utilisateur / mois", "Gratuit"],
    ["Stockage", "Cloud", "Fichiers locaux"]
  ]
}

Des liens vers d'autres pages de votre website.

paths : une liste de chemins de pages. Même langue que la page.
Les chemins ne sont pas vérifiés à l'enregistrement. Vous devez donner des chemins corrects.
Les pages non publiées sont retirées à l'affichage. Un brouillon ou une faute de frappe n'affiche rien.
Chaque lien affiche le titre de la page.

{ "type": "related", "paths": ["/vs/notion-vs-obsidian", "/alternatives/notion"] }

space

Un espace vide entre deux blocs. Il n'a aucun champ.

{ "type": "space" }

Exemple complet

{
  "title": "Notion vs Obsidian",
  "blocks": [
    { "type": "description", "content": "Notion est **en ligne et partagé**. Obsidian est **local et gratuit**." },
    { "type": "heading", "level": 2, "content": "Comparatif rapide" },
    {
      "type": "table",
      "headers": ["", "Notion", "Obsidian"],
      "rows": [["Prix", "10 $ / utilisateur / mois", "Gratuit"]]
    },
    { "type": "space" },
    { "type": "related", "paths": ["/alternatives/notion"] }
  ]
}

Limites

Jusqu'à 100 blocs par page.
Environ 50 Ko par page.
blocks est remplacé en entier quand votre IA met à jour une page.

Voir aussi Écrire de bonnes pages.

Mis à jour 31 octobre 2026