LaTeX zu SVG
Rendere eine LaTeX-Formel mit KaTeX 0.19.1, der im Web verwendeten Engine für mathematischen Schriftsatz, als eigenständige SVG-Datei. Wähle den Anzeige- oder Inline-Modus und eine Schriftgröße in Pixeln. Die Dateigröße wird anhand der Schriftmetriken von KaTeX bestimmt. Das Stylesheet von KaTeX und nur die von der Formel verwendeten Schriftarten werden eingebettet, damit sie in jedem Webbrowser gleich aussieht. Ideal für Webseiten, Dokumentation, Blogs und Folien, die im Browser erstellt werden.
Häufig gestellte Fragen
Wie wird das SVG ohne Browser erstellt?
KaTeX setzt die Formel auf dem Server als HTML, und das Werkzeug verpackt dieses HTML zusammen mit dem Stylesheet von KaTeX und den benötigten woff2-Schriftdateien in ein SVG-foreignObject. Die Schriftdateien sind als Daten-URLs eingebettet. Breite und Höhe ergeben sich aus den Schriftmetriken von KaTeX und den tatsächlichen Glyphenbreiten dieser Schriftarten, sodass die Zeichenfläche mit einem kleinen Rand genau um die Formel passt.
Wo wird das SVG korrekt angezeigt?
Es wird in Chrome, Edge, Firefox und Safari korrekt angezeigt, egal ob du es als img-Element, als CSS-Hintergrund, als Inline-SVG-Markup oder durch direktes Öffnen der Datei verwendest. Das gilt auch für Apps, die auf einer Browser-Engine basieren. Vektorgrafik-Editoren und Konverter wie Inkscape, Illustrator, der SVG-Import von Figma, librsvg und resvg rendern HTML in foreignObject nicht, weshalb die Formel dort leer erscheint.
Warum wird die Formel nicht in Vektorpfade umgewandelt?
Keine permissiv lizenzierte Bibliothek in diesem Tool-Stack setzt KaTeX-Mathematik als Glyphenumrisse, und ein separater Satz würde nicht mit der Ausgabe von KaTeX übereinstimmen. Das Einbetten von KaTeX-eigenem HTML bewahrt den exakten Abstand und die Schriftarten. Wenn ein Vektoreditor Umrisse benötigt, öffne das SVG in einem Browser und drucke es als PDF, damit die Formel als Vektorformen erhalten bleibt, die Editoren importieren können.
Was ist der Unterschied zwischen Display- und Inline-Modus?
Im Display-Modus wird die Formel als eigenständige Gleichung gesetzt: Bei großen Operatoren stehen die Grenzen darüber und darunter, Brüche behalten ihre volle Größe und \tag-Nummern sind zulässig. Im Inline-Modus wird der kompakte Textstil für Formeln in einem Satz verwendet, mit kleineren Brüchen und Grenzen neben Summen und Integralen.
Was bewirkt die Schriftgröße?
Sie legt die Größe der Mathematikschrift in Pixeln fest, als ganze Zahl zwischen 8 und 200, wobei 24 der Standardwert ist. Breite und Höhe des SVG skalieren entsprechend mit, sodass eine mit 48 Pixeln gerenderte Formel doppelt so groß ist wie eine mit 24 Pixeln. Da das Ergebnis vektorbasiert ist, kannst du es später mit CSS weiter skalieren.
Welche LaTeX-Befehle werden unterstützt?
Alles, was KaTeX 0.19.1 unterstützt: Brüche, Wurzeln, Summen und Integrale, Matrizen und Umgebungen wie aligned, cases, pmatrix und array, Akzente, Pfeile, \mathbb, \mathcal, \mathfrak, \text, \color und \tag. Mit \def oder \newcommand kannst du innerhalb der Formel eigene Makros definieren. Vollständige Dokumente, \usepackage, TikZ und die \ce-Befehle von mhchem sind nicht verfügbar.
Was passiert, wenn die Formel einen Fehler enthält?
Es wird keine Datei erstellt und das Tool teilt dir mit, was schiefgelaufen ist und an welchem Zeichen, gezählt ab 1. Es nennt unbekannte Befehle, nicht ausgeglichene geschweifte Klammern, doppelte Hochstellungen und Befehle, denen ein Argument fehlt, damit du direkt zur Stelle springen und den Fehler beheben kannst.
Gibt es Einschränkungen?
Eine Formel darf bis zu 10,000 Zeichen lang sein, Makros dürfen höchstens 1,000-mal erweitert werden und Größen für Befehle wie \rule, \kern und \hspace sind auf 100em begrenzt. Befehle, die externe Inhalte laden oder verlinken, etwa \href, \url und \includegraphics, sind deaktiviert und erscheinen als nicht unterstützter roter Text.
Welche Farbe und welchen Hintergrund hat das SVG?
Der Hintergrund ist transparent. Wenn du das SVG-Markup in eine HTML-Seite einfügst, übernimmt die Formel die Textfarbe des umgebenden Elements; als Bilddatei wird sie schwarz dargestellt. Mit \color oder \textcolor innerhalb der Formel legst du Farben fest, die überall gleich bleiben.
Wie groß ist die Datei und ist sie barrierefrei?
Jede Datei enthält das Stylesheet von KaTeX mit etwa 24 KB und jede verwendete Schriftart als Base64-woff2, sodass eine typische Formel 75 bis 150 KB groß ist. Zeichen, die in den KaTeX-Schriftarten fehlen, etwa chinesische oder japanische Zeichen innerhalb von \text, verwenden die Schriftarten des jeweiligen Viewers. Das SVG hat die Rolle img sowie den LaTeX-Quelltext als Titel und als aria-label für Screenreader.