[Moodle|Guide] Insérer des équations dans une zone de texte (atto)

[Moodle|Guide] Insérer des équations dans une zone de texte (atto)

Objectif

Ce guide explique comment insérer des équations mathématiques et chimiques dans une zone de texte Moodle (consigne de devoir, question de test, forum, page…).


Instructions

Des outils d’aide à l'édition d'équations sont intégrés à notre instance Moodle. Toutefois, nous vous conseillons plutôt d’opter pour l’intégration directe de code LaTeX, si vous êtes à l’aise avec sa syntaxe. Cette solution est beaucoup plus souple, et finalement plus simple à mettre en œuvre et à maintenir.

Outils d’assistance à l'édition d'équations

Éditeur d’équations mathématiques

L’éditeur ATTO comporte un bouton « Éditeur d’équations » permettant de composer visuellement des formules au format LaTeX. Cet éditeur est particulièrement utile si vous ne maîtrisez pas encore la syntaxe LaTeX : il génère pour vous le code nécessaire.

Éditeur d’équations chimiques

Attention : depuis la mise à jour 2025 de Moodle, le bouton Chemistry Editor n’est plus fonctionnel. Cela est dû au fait que ce plugin n’est plus régulièrement mis à jour par ses développeurs. Nous leur avons signalé le problème.

En attendant une résolution du bug, nous vous conseillons de passer par l’option présentée dans la section suivante.

L'éditeur de texte de Moodle UCLouvain est configuré avec un bouton qui vous permet de composer des formules chimiques au format LaTeX via un éditeur visuel. Si vous ne maîtrisez pas le code LaTeX, l’utilisation de cet éditeur vous aidera à vous habituer à la syntaxe.

Insérer une équation via LaTeX

MathJax interprète deux types de délimiteurs dans l’éditeur ATTO.

Pour écrire du code LaTeX sur une ligne séparée, comme une équation, entourer le code LaTeX avec \[et \].

\[ ... \]

Pour écrire du code LaTeX au fil du texte, insérez votre code LaTeX entre deux séquences $$.

$$ ... $$

Ces deux formats fonctionnent aussi bien pour les mathématiques que pour la chimie.

La plupart des syntaxes LaTeX courantes sont interprétées par MathJax :

  • Mathématiques (TeX standard)

    • exposants et indices : x^2, a_{ij}

    • fractions et racines : \frac{a}{b}, \sqrt{...}

    • lettres grecques et symboles : \alpha, \beta, \infty

    • flèches : \rightarrow, \leftrightarrow

    • fonctions : \sin, \cos, \log, \int

    • matrices :
      \begin{pmatrix} ... \end{pmatrix}

    • alignements :
      \begin{align} ... \end{align}

  • Chimie (MHchem)

    • réactions : \ce{A + B -> C}

    • ions : \ce{SO4^2-}

    • états : \ce{H2O(l)}, \ce{NaCl(s)}

    • précipités / gaz : \ce{AgCl v}, \ce{CO2(g)}

Cette liste n’est pas exhaustive. Pour des syntaxes avancées : consulter la documentation MathJax (TeX) ou MHchem. Vous pouvez aussi vous référer à la documentation Moodle.

Si vous n'êtes pas familier·e de LaTeX, il vous est possible d’utiliser un éditeur en ligne de type WYSIWYG, pour vous assister dans l’édition d'équations en LaTeX. Il vous suffira alors de copier le code généré dans l'éditeur, entre les bonnes balises.

Exemples

Mathématique

Mathématique

Soit $$ f(x)=\sin(x) $$. Calculez l'intégrale de cette fonction de 0 à $$ \pi $$. \[ \int_0^\pi \sin(x)\, dx = ? \]

Chimie

\[ \ce{SO4^2- + Ba^2+ -> BaSO4 v} \]
image-20250826-085649.png
Ma formule $$ \ce{SO4^2- + Ba^2+ -> BaSO4 v} $$ insérée dans le texte.
image-20250826-085716.png

Résultat

En utilisant ces syntaxes :

  • vos équations sont correctement affichées dans Moodle,

  • elles s’intègrent dans n’importe quel contenu (devoirs, tests, forums…),

  • elles restent lisibles sur tous les appareils,

  • et vous pouvez les rééditer facilement puisque tout repose sur du texte LaTeX.


Ressources complémentaires