Convertir des équations LaTeX en images

Pourquoi convertir des équations en images ?

LaTeX offre la référence en matière de composition mathématique, mais le résultat reste enfermé dans des fichiers PDF compilés par un moteur TeX. La plupart des endroits où vous devez réellement afficher des mathématiques (présentations, sites web, messages de chat, documents Word, fichiers README) ne savent pas interpréter du code source LaTeX. Convertir votre équation en image comble ce fossé : vous obtenez une typographie de qualité LaTeX dans un format qui fonctionne partout.

L'alternative consiste à approximer le rendu en JavaScript (KaTeX, MathJax) ou à utiliser l'éditeur d'équations d'un traitement de texte. Les moteurs de rendu JavaScript couvrent un sous-ensemble utile de LaTeX mais ignorent les cas limites, les paquets personnalisés et les environnements avancés. Les éditeurs d'équations intégrés (Microsoft Equation, Google Docs) produisent une typographie nettement différente qui jure avec les documents LaTeX. Un rendu côté serveur par un vrai moteur TeX évite ces deux problèmes.

Comparaison des formats de sortie

Chaque format de sortie a ses atouts. Le PNG est la solution de repli universelle ; le SVG est idéal pour le web ; le PDF convient parfaitement à l'impression ; le MathML est la norme d'accessibilité. Le tableau ci-dessous résume les principales différences pour vous aider à choisir.

Pas à pas : convertir avec FormaTeX

Que vous utilisiez l' outil en ligne ou l'API REST, le flux de travail suit quatre étapes. L'outil en ligne propose une interface visuelle pour chaque option ; l'API accepte les mêmes paramètres sous forme de champs JSON.

Options de rendu avancées

Les réglages par défaut donnent d'excellents résultats dans la plupart des cas. Lorsque vous avez besoin d'un contrôle précis sur la sortie, les options suivantes sont disponibles dans l'outil en ligne comme dans l'API. Chaque option est transmise sous forme de champ JSON dans le corps de la requête API.

Ces options peuvent être combinées librement. Par exemple, vous pouvez produire une équation blanche sur fond transparent à 300 DPI en Latin Modern à 14 pt avec le paquet siunitx chargé, le tout en une seule requête.

"dpi": 300

"transparent": true

"color": "#ffffff", "bg_color": "#1a1a2e"

"font_size": 14

"font_family": "Latin Modern"

"preamble": "\\newcommand{\\R}{\\mathbb{R}}"

"packages": ["siunitx", "chemformula"]

Intégrer des équations sur le web

Une fois votre équation rendue, l'étape suivante consiste à l'intégrer dans votre page HTML, article de blog ou site de documentation. Il existe trois méthodes principales, chacune avec ses compromis en matière de performance, d'accessibilité et de facilité d'intégration.

Pour la plupart des projets web, le SVG en ligne offre le meilleur équilibre entre qualité et performance. Utilisez l'approche avec la balise img lorsque vous avez besoin du chargement différé ou de la mise en cache CDN. Choisissez MathML lorsque la conformité en matière d'accessibilité (WCAG, Section 508) est exigée.

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 40">
  <!-- SVG content from the API response -->
</svg>

<img
  src="https://api.formatex.io/api/v1/render/equation?latex=E%3Dmc%5E%7B2%7D&format=svg"
  alt="E equals m c squared"
  width="120"
  height="40"
  loading="lazy"
/>

<math xmlns="http://www.w3.org/1998/Math/MathML" display="block">
  <mi>E</mi>
  <mo>=</mo>
  <mi>m</mi>
  <msup><mi>c</mi><mn>2</mn></msup>
</math>

Utiliser l'API

L'API de rendu d'équations FormaTeX accepte une requête POST avec un corps JSON. Authentifiez-vous avec un jeton Bearer (votre clé API, générée depuis le tableau de bord ). Le corps de la réponse contient les octets de l'image rendue. Pour la documentation complète de l'API et les bibliothèques clientes, consultez le guide de l'API Python et la référence cURL .

Voici deux exemples : une commande cURL pour produire un PNG à 300 DPI sur fond transparent, et une commande cURL pour produire un SVG d'une intégrale gaussienne.

# Render a LaTeX equation as a transparent PNG at 300 DPI
curl -X POST https://api.formatex.io/api/v1/render/equation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "latex": "E = mc^{2}",
    "format": "png",
    "dpi": 300,
    "transparent": true
  }' \
  --output equation.png

# Render a LaTeX equation as an inline SVG
curl -X POST https://api.formatex.io/api/v1/render/equation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "latex": "\\int_{0}^{\\infty} e^{-x^2} \\, dx = \\frac{\\sqrt{\\pi}}{2}",
    "format": "svg",
    "font_size": 14
  }' \
  --output equation.svg

#!/bin/bash
EQUATIONS=("E = mc^{2}" "a^2 + b^2 = c^2" "\\sum_{n=1}^{\\infty} \\frac{1}{n^2} = \\frac{\\pi^2}{6}")
API_KEY="YOUR_API_KEY"

for i in "${!EQUATIONS[@]}"; do
  curl -s -X POST https://api.formatex.io/api/v1/render/equation \
    -H "Authorization: Bearer $API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"latex\": \"${EQUATIONS[$i]}\", \"format\": \"png\", \"dpi\": 300}" \
    --output "equation_$i.png"
  echo "Rendered equation_$i.png"
done

import requests

response = requests.post(
    "https://api.formatex.io/api/v1/render/equation",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "latex": r"\nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t}",
        "format": "svg",
        "font_size": 14,
    },
)

with open("maxwell.svg", "wb") as f:
    f.write(response.content)

print(f"Status: {response.status_code}, saved maxwell.svg")

FormaTeX face aux alternatives

Il existe plusieurs façons de convertir des équations LaTeX en images, des outils côté serveur qui exécutent un moteur TeX complet aux bibliothèques JavaScript côté client qui approximent LaTeX dans le navigateur. Le bon choix dépend de vos exigences : fidélité du rendu, options de format, accès à une API, prise en charge des paquets et tarification.

Les outils côté serveur (FormaTeX, CodeCogs, LaTeX2Image, QuickLaTeX) produisent un résultat identique à du LaTeX compilé, car ils exécutent un vrai moteur TeX. Les outils côté client (KaTeX, MathJax) effectuent le rendu dans le navigateur avec JavaScript et couvrent un sous-ensemble large mais incomplet de LaTeX. Pour une comparaison détaillée, consultez la comparaison complète des outils de rendu d'équations .

À retenir : si vous avez besoin d'un rendu LaTeX parfait au pixel près, avec prise en charge complète des paquets et une API REST, FormaTeX est l'option la plus complète. Si vous n'avez besoin que d'un rendu dans le navigateur et pas d'images téléchargeables, KaTeX (le plus rapide) ou MathJax (la couverture LaTeX la plus large) sont d'excellents choix open source.

Questions fréquentes

Guides et outils associés