Mathpix und Marker: Bei der Umwandlung formelreicher PDFs in bearbeitbare Lehrunterlagen zuerst auf das Zielformat achten

Sollen Lehrende oder Forschende formelreiche PDFs weiterbearbeiten, eignet sich die gehostete Mathpix-API eher für DOCX- und LaTeX-Ausgaben. Marker passt eher zu Teams, die lokale Inferenz und Nachbearbeitung betreuen können. Vor der Wahl sind die Bearbeitbarkeit von Formeln, Tabellen und Bildern im endgültigen Editor sowie Laufzeitabhängigkeiten und Modelllizenzen getrennt zu prüfen.

Quelle: docs.mathpix.com
November 11, 2026
5 min

Wenn alte Skripte oder wissenschaftliche PDFs zu neuem Lehr- und Forschungsmaterial werden sollen, wird die Arbeit nach der Konvertierung leicht unterschätzt: Eine Hilfskraft muss einen Index ändern, eine Forscherin eine Tabellenzeile ergänzen, ein Kollege Abbildungen zusammen mit dem Text übernehmen. Inhalte anzeigen zu können ist noch nicht dasselbe wie sie weiterbearbeiten zu können.

Ist das Ziel DOCX oder LaTeX und dürfen die Materialien hochgeladen werden, prüfen Sie zuerst die gehostete Mathpix-API. Soll das Team den lokalen Verarbeitungsprozess kontrollieren und gibt es Verantwortliche für Inferenzumgebung und Ausgabeanpassung, kommt Marker infrage. Diese Einschätzung beruht auf offiziellen Schnittstellen und Bereitstellungsgrenzen, nicht auf einer durch Tests ermittelten Rangfolge der Erkennungsgenauigkeit oder Geschwindigkeit.

Die Unterschiede bei der Übergabe am selben Skript prüfen

Angenommen, ein Skript mit mehrzeiligen Formeln, Tabellen mit verbundenen Zellen und Abbildungen von Versuchen soll zu wiederverwendbarem Lehrmaterial werden. Mathpix’ Anleitung zur Dokumentverarbeitung beschreibt Einreichung per Upload oder URL, Statusabfrage und Ergebnisdownload. DOCX und tex.zip können angefordert werden. Nach Abschluss der OCR-Verarbeitung muss der Konvertierungsstatus des Zielformats zusätzlich geprüft werden. Für Redaktionsteams sollte der Übergabepunkt eine Datei sein, die sich öffnen und ändern lässt, nicht lediglich eine erfolgreich zurückgegebene Auftragsnummer.

Das Zwischenformat Mathpix Markdown erweitert Markdown um LaTeX-Formeln und nummerierte Verweise, komplexe Tabellen und Bildreferenzsyntax. Es darf nicht vorausgesetzt werden, dass jeder Markdown-Editor diese Strukturen korrekt darstellt. Arbeiten Kollegen hauptsächlich in Word, liefern und prüfen Sie zuerst DOCX. Wird gemeinsam LaTeX gepflegt, prüfen Sie das exportierte Projekt und seine Bildressourcen. Werden Erkennungsfehler im Zwischenformat korrigiert, lässt sich das Zielformat über die Markdown-Konvertierungsschnittstelle neu erzeugen. So werden Fehler nicht nur in der Enddatei repariert, um beim nächsten Export erneut aufzutauchen.

Das offizielle Marker-Projekt gibt unter anderem Markdown, JSON und HTML aus. Markdown enthält LaTeX-Formeln und Bildlinks; Bilder werden separat im selben Verzeichnis gespeichert. Diese Ausgabe eignet sich eher als Eingang in einen eigenen Bearbeitungs- oder Konvertierungsablauf. Wird nur die Markdown-Datei an Kollegen geschickt, können Abbildungen fehlen. Teams mit DOCX-Bedarf müssen auch die nachgelagerte Konvertierung und Abnahme übernehmen. Ähnliche Formatnamen bedeuten keine gleichwertige Übergabe.

Beide Wege sollten eine korrigierbare Quelldatei erhalten. Ein korrekt aussehender Formelscreenshot erfüllt nicht die Anforderung, einen Index bearbeiten zu können. Eine gut lesbare Tabelle garantiert keine weiter bearbeitbaren Zeilen- und Spaltenbeziehungen. Dass ein Bild extrahiert wurde, bedeutet erst recht nicht, dass seine Kurven und Beschriftungen zu bearbeitbaren Grafikobjekten geworden sind.

Lokale Kontrolle zusammen mit der Betriebsverantwortung wählen

Kennzeichnete die Paketkonfiguration im Marker-Hauptzweig die Version 2.1.0 mit dem Abhängigkeitsbereich surya-ocr>=0.23.0,<0.24.0. Das ist eine Softwarepaketversion. Surya 2.5 in der Surya-Dokumentation ist dagegen ein Modellname; beide dürfen nicht als dieselbe Versionsnummer behandelt werden. Die aktuelle Inferenz benötigt passende Backends: Der NVIDIA-Weg umfasst vLLM, Docker und NVIDIA Container Toolkit, CPU- oder Apple-Silicon-Wege verwenden llama.cpp. Das Budget muss die Pflege dieser Umgebungen einschließen, nicht nur die Installation eines Python-Pakets.

Markers Betriebsmodi verändern auch die Formelverarbeitung. Laut offizieller Beschreibung verarbeitet balanced Inline-Mathematik automatisch. Im fast-Modus muss Inline-Mathematik entsprechend aktiviert oder OCR erzwungen werden. Wird OCR abgeschaltet, entfallen die für Formeln und gescannte Seiten nötigen Modellaufrufe. Reine Textextraktion mit deaktivierter OCR kann deshalb nicht als Maßstab für die vollständigen Konvertierungskosten formelreicher Materialien dienen.

Eine lokale Installation beweist noch keinen vollständig offline ablaufenden Prozess. Wird Markers optionale LLM-Erweiterung mit einem Cloud-Dienst verbunden, ändert sich die Verarbeitungsgrenze. Teams mit Netztrennung sollten zunächst Abhängigkeiten und Modellressourcen vorbereiten, Adressen der Inferenzdienste sowie sämtliche Erweiterungsfunktionen prüfen und anschließend den vollständigen Auftrag ohne Netzwerkverbindung testen. Bei Mathpix wird hier die gehostete API verglichen, doch die offizielle Dokumentation nennt auch Private Cloud OCR. Benötigt eine Einrichtung private Infrastruktur und möchte zugleich diese Modelle einsetzen, ist diese Bereitstellungsform gesondert zu prüfen. Mathpix darf nicht pauschal als ausschließlich über öffentliche Cloud-Uploads nutzbar dargestellt werden.

Auch Lizenzen sind getrennt zu prüfen. Die Marker-Paketkonfiguration nennt Apache-2.0 für den Code; Modellgewichte unterliegen separat der MODEL_LICENSE. Diese Datei enthält Einschränkungen für Fälle mit mehr als 5 Millionen US-Dollar Gesamtumsatz im Vorjahr oder mehr als 5 Millionen US-Dollar kumulierter Eigen- oder Fremdkapitalfinanzierung. Sie nennt Ausnahmen für persönliche Nutzung oder Forschung sowie zusätzliche Einschränkungen für konkurrierende Produkte oder Dienste. Die Erstellung von Lehrmaterial bedeutet nicht automatisch, dass jedes kommerzielle Schulungsunternehmen die Voraussetzungen für eine kostenlose Nutzung erfüllt. Vor dem verbindlichen Einsatz sind tatsächlicher Rechtsträger, Zweck und verwendete Gewichte anhand der Lizenz zu prüfen.

Die letzte Bearbeitung über das Testergebnis entscheiden lassen

Wählen Sie als kleinen Test einen Teil echter Materialien aus, erstellen Sie über beide Wege dieselbe Lieferung und lassen Sie die tatsächlichen Empfänger damit arbeiten. Folgendes ist ein Abnahmeplan, kein bereits durchgeführter Test:

  • Ändern Sie einen hoch- oder tiefgestellten Index in einer Formel und setzen Sie sie neu. Prüfen Sie, ob Symbole, Klammern und nummerierte Verweise weiterhin stimmen.
  • Fügen Sie einer komplexen Tabelle eine Zeile hinzu und kontrollieren Sie verbundene Zellen, Spaltenüberschriften und die Zuordnung der Werte, statt nur einen gerenderten Screenshot anzusehen.
  • Kopieren Sie das gesamte Material auf einen anderen Computer und prüfen Sie, ob Abbildungen, relative Pfade und Verweise im Text weiterhin funktionieren.
  • Erfassen Sie die Zeit für manuelle Korrekturen nach der Erkennung, die Anpassung des Exports und Kosten fehlgeschlagener Wiederholungsläufe. Cloud-Aufrufkosten oder lokaler Betrieb und Wartung gehören in dasselbe Budget.

Erfüllen Mathpix-Exportdateien bereits die Anforderungen der Bearbeitenden und ist das Hochladen zulässig, kann die gehostete API die Verantwortung für eine selbst aufgebaute Inferenzkette ersparen. Lassen sich Markers Ausgaben in die vorhandene Toolchain integrieren und kann das Team Umgebung, Lizenzen und das Verpacken der Materialien betreuen, erhält die Kontrolle der lokalen Lösung einen praktischen Wert. Verglichen werden sollte letztlich das korrigierte Material in den Händen der Kollegen, nicht wie ordentlich das frisch erzeugte Markdown aussieht.

Hinweis zum Inhalt:Dieser Artikel basiert auf öffentlich verfügbaren Informationen und dient als Orientierung bei der Auswahl von Tools. Funktionen, Preise und zugehörige Richtlinien können sich jederzeit ändern; maßgeblich sind die aktuellen offiziellen Angaben.

Originalquelle:docs.mathpix.com