Sarmate.net Sarmate.net
Accueil Fonctionnalités Offres Documentation Contact
Connexion Inscription
Web scientifique 7 min

Structure d'un document mathpad

Tout document mathpad suit une hiérarchie simple et sémantique : une racine <mp-course>, un bloc d'en-tête <mp-meta>, puis des chapitres et sections. Cette page décrit chaque balise de structure et ses attributs — la charpente commune à tous vos documents.

Anatomie d'un document

Voici la hiérarchie type d'un document mathpad — simplifiée. Les éléments obligatoires sont en gras, les optionnels en normal :

<mp-course> ├── <mp-meta> │ ├── <mp-doc-title> │ ├── <mp-author> │ └── <mp-date> ├── <mp-toc> ← optionnel, table des matières auto ├── <mp-chapter> │ ├── <mp-title> │ ├── <mp-section> │ │ ├── <mp-title> │ │ ├── <mp-definition> │ │ ├── <mp-theorem> │ │ ├── <mp-exercise> │ │ └── ... │ └── <mp-subsection> │ └── ... └── <mp-chapter> └── ...
Encapsulation automatique Si vous placez du contenu pédagogique (<mp-definition>, <mp-exercise>…) directement dans le <body> sans l'envelopper dans <mp-course> / <mp-chapter>, mathpad.js les enveloppe automatiquement pour hériter du système de thèmes, navigation et numérotation. Vous pouvez démarrer avec très peu de balises.

<mp-course> — la racine

Enveloppe tout le document. Active la numérotation automatique (Définition 1, Théorème 2…), le système de thèmes, la barre de navigation du bas et le sélecteur de thème.

Attributs importants

AttributValeursDescription
langfr | en | de | esLangue des libellés auto (Définition / Théorème / Exemple…)
themeocean · foret · lavande · corail · rose · ardoise · sepia · nuit · minuit · original · classiquePalette de couleurs initiale (défaut ocean)
theme-pickeron | offAffiche ou cache le bouton flottant de changement de thème
navigationauto | on | offBarre de navigation du bas (défaut auto = on s'il y a au moins un <mp-blank>)
creditvisible | hiddenLien « Créé avec sarmate.net » (défaut visible — masquable dans les plans payants)
vartable-scalenumerisch (0.2 – 3) oder compact | normal | largeTaille par défaut de tous les <mp-vartable> enfants (peut être surchargée par tableau)
exercise-headingstacked | inline« Exercice 1 : Titre » sur une ligne (inline) ou empilé (défaut stacked)
HTML
<mp-course lang="fr" theme="ocean" exercise-heading="inline" vartable-scale="0.85">
  ...
</mp-course>

<mp-meta> — l'en-tête du document

Génère un grand bloc-titre avec dégradé (équivalent à \maketitle en LaTeX). Accepte <mp-doc-title>, optionnel <mp-author>, optionnel <mp-date>.

HTML
<mp-meta>
  <mp-doc-title>Fonctions affines</mp-doc-title>
  <mp-author>Prénom Nom</mp-author>
  <mp-date>22-11-2026</mp-date>
</mp-meta>

<mp-chapter>, <mp-section>, <mp-subsection>

Trois niveaux hiérarchiques numérotés automatiquement :

Chaque niveau prend un <mp-title> comme premier enfant. Important : un <mp-section> doit être enfant direct d'un <mp-chapter> (pas frère), sinon il n'apparaît pas dans la table des matières.

HTML
<mp-chapter><mp-title>Étude de fonction</mp-title>

  <mp-section><mp-title>Ensemble de définition</mp-title>
    <!-- contenu -->
  </mp-section>

  <mp-section><mp-title>Variations</mp-title>
    <mp-subsection><mp-title>Calcul de la dérivée</mp-title>
      <!-- ... -->
    </mp-subsection>
  </mp-section>

</mp-chapter>
Astuce de l'éditeur Dans l'éditeur en ligne, le bouton Chapitre / Section / Sous-section insère un squelette pré-rempli avec un commentaire d'aide « Insérer vos sections ici (mp-section) » qui rappelle de respecter la hiérarchie. Utile quand on vient de LaTeX où \section / \subsection s'enchaînent à plat.

<mp-toc> — table des matières automatique

Génère une table des matières navigable à partir des <mp-chapter> / <mp-section> / <mp-subsection> présents. Compatible avec les formules KaTeX dans les titres.

AttributValeursDescription
depth1 | 2 | 31 = chapitres seuls · 2 = + sections · 3 = + sous-sections (défaut 3)
titleTexte libreRemplace le libellé par défaut « Table des matières »
layoutsidebarAncre la TOC en barre latérale (highlight de la section active au scroll)
HTML
<mp-toc depth="3"></mp-toc>

Exemple complet

Voici un minimum de structure : en-tête + table des matières + un chapitre avec deux sections.

HTML
<mp-course lang="fr" theme="ocean">

  <mp-meta>
    <mp-doc-title>Lois de probabilité</mp-doc-title>
    <mp-author>Prénom Nom</mp-author>
    <mp-date>22-11-2026</mp-date>
  </mp-meta>

  <mp-toc depth="2"></mp-toc>

  <mp-chapter><mp-title>Lois discrètes</mp-title>

    <mp-section><mp-title>Loi binomiale</mp-title>
      <!-- définitions, théorèmes, exercices… -->
    </mp-section>

    <mp-section><mp-title>Loi de Poisson</mp-title>
      <!-- ... -->
    </mp-section>

  </mp-chapter>

</mp-course>

Prêt à essayer mathpad ?

Créez votre premier document scientifique en HTML dans l'éditeur en ligne, ou importez votre cours LaTeX existant en un clic.