Renderice ecuaciones de LaTeX como imágenes

¿Por qué renderizar las ecuaciones como imágenes?

LaTeX ofrece la referencia de oro en composición matemática, pero su resultado queda encerrado en archivos PDF compilados por un motor TeX. La mayoría de los lugares donde realmente necesita mostrar matemáticas (presentaciones, sitios web, mensajes de chat, documentos de Word, archivos README) no pueden interpretar código LaTeX. Renderizar su ecuación como imagen cierra esa brecha: obtiene una tipografía con calidad de LaTeX en un formato que funciona en todas partes.

La alternativa es aproximar el renderizado con JavaScript (KaTeX, MathJax) o usar el editor de ecuaciones integrado de un procesador de texto. Los renderizadores de JavaScript cubren un subconjunto útil de LaTeX, pero fallan en casos límite, paquetes personalizados y entornos avanzados. Los editores de ecuaciones integrados (Microsoft Equation, Google Docs) producen una tipografía visiblemente distinta que desentona con los documentos LaTeX. Un renderizado en el servidor con un motor TeX real evita ambos problemas.

Comparación de los formatos de salida

Cada formato de salida tiene puntos fuertes distintos. PNG es la opción universal de reserva; SVG es lo mejor para la web; PDF es ideal para impresión; MathML es el estándar de accesibilidad. La tabla siguiente resume las diferencias clave para ayudarle a elegir.

Paso a paso: renderice con FormaTeX

Tanto si usa la herramienta en línea como la API REST, el flujo de trabajo consta de cuatro pasos. La herramienta en línea ofrece una interfaz visual para cada opción; la API acepta los mismos parámetros como campos JSON.

Opciones avanzadas de renderizado

La configuración predeterminada produce excelentes resultados en la mayoría de los casos. Cuando necesite un control más preciso de la salida, dispone de las siguientes opciones tanto en la herramienta en línea como en la API. Cada opción se pasa como un campo JSON en el cuerpo de la solicitud a la API.

Estas opciones pueden combinarse libremente. Por ejemplo, puede renderizar una ecuación blanca sobre fondo transparente a 300 DPI con Latin Modern a 14 pt y el paquete siunitx cargado, todo en una sola solicitud.

"dpi": 300

"transparent": true

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

"font_size": 14

"font_family": "Latin Modern"

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

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

Incrustar ecuaciones en la web

Una vez renderizada su ecuación, el siguiente paso es incrustarla en su página HTML, entrada de blog o sitio de documentación. Hay tres métodos principales, cada uno con distintas ventajas e inconvenientes en rendimiento, accesibilidad y facilidad de integración.

En la mayoría de los proyectos web, el SVG en línea ofrece el mejor equilibrio entre calidad y rendimiento. Use la etiqueta img cuando necesite carga diferida o caché en una CDN. Elija MathML cuando se exija cumplir normas de accesibilidad (WCAG, Section 508).

<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>

Uso de la API

La API de renderizado de ecuaciones de FormaTeX acepta una solicitud POST con un cuerpo JSON. Autentíquese con un token Bearer (su clave de API, generada desde el panel ). El cuerpo de la respuesta contiene los bytes de la imagen renderizada. Para consultar la documentación completa de la API y las bibliotecas cliente, vea la guía de la API de Python y la referencia de cURL .

A continuación se muestran dos ejemplos: un comando cURL para renderizar un PNG a 300 DPI con fondo transparente y otro para renderizar un SVG de una integral gaussiana.

# 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 frente a las alternativas

Hay varias formas de renderizar ecuaciones de LaTeX como imágenes, desde herramientas en el servidor que ejecutan un motor TeX completo hasta bibliotecas de JavaScript en el cliente que aproximan LaTeX en el navegador. La elección adecuada depende de sus requisitos: fidelidad de la salida, opciones de formato, acceso a la API, compatibilidad con paquetes y precio.

Las herramientas en el servidor (FormaTeX, CodeCogs, LaTeX2Image, QuickLaTeX) producen una salida idéntica a LaTeX compilado porque ejecutan un motor TeX real. Las herramientas en el cliente (KaTeX, MathJax) renderizan en el navegador con JavaScript y cubren un subconjunto amplio pero incompleto de LaTeX. Para una comparación detallada, consulte la comparación completa de renderizadores de ecuaciones .

Conclusión clave: si necesita una salida de LaTeX perfecta al píxel, con compatibilidad completa de paquetes y una API REST, FormaTeX es la opción más completa. Si solo necesita renderizado en línea en el navegador y no requiere imágenes descargables, KaTeX (el más rápido) o MathJax (la cobertura de LaTeX más amplia) son excelentes opciones de código abierto.

Preguntas frecuentes

Guías y herramientas relacionadas