Warum normale OCR Code verstümmelt
Allgemeine Texterkennung ist für Fließtext gebaut. Sie behandelt Leerzeichen am Zeilenanfang als Rauschen, verbindet Zeilen, die scheinbar zusammengehören, und übernimmt jedes Anführungszeichen so, wie sie es sieht. Für einen Absatz ist das in Ordnung, für Code nicht: Python läuft nicht mehr, wenn die Einrückung fehlt, YAML ändert seine Bedeutung, und ein einziges typografisches Anführungszeichen von einer Präsentationsfolie macht aus einem String einen Syntaxfehler.
Der Codemodus liest das Bild anders:
- Einrückung und Abstände bleiben erhalten, Zeile für Zeile, sodass verschachtelte Blöcke verschachtelt bleiben.
- Typografische Anführungszeichen werden begradigt: Aus
„hallo“,“hello”und‘a’werden"hallo","hello"und'a'. - Die Sprache wird genannt, sobald sie erkannt wird, etwa „Sieht nach einem Screenshot mit Python-Code aus“ – ein schnelles Zeichen dafür, dass der Modus zum Bild passt.
Lädst du eine Markdown-Datei herunter, steht der Code in einem Fenced Code Block, also zwischen drei Backticks – bereit für eine README, eine Wiki-Seite oder deine Notizen.
Dark Themes und farbige Syntax
Die meisten Editoren und Terminals nutzen inzwischen dunkle Themes, OCR-Engines lesen aber dunklen Text auf hellem Grund am besten. „Automatisch verbessern“ erkennt hellen Text auf dunklem Grund und kehrt ihn vor dem Lesen um. Screenshots im Dark Mode musst du also nicht vorbereiten.
Farbige Syntax ist meist ebenfalls kein Problem. Die schwächsten Stellen sind kontrastarme Teile eines Themes: graue Kommentare auf dunkelgrauem Grund oder blasse Markierungen für Leerzeichen. Kommen sie verstümmelt heraus, probier „Graustufen“ und etwas mehr Kontrast und wechsle dann zur bereinigten Ansicht, um zu prüfen, dass dabei nichts verloren gegangen ist.
Zeichen, die du doppelt prüfen solltest
Manche Zeichen sehen in vielen Programmierschriften fast gleich aus, und ein kleiner Screenshot macht es noch schlimmer. Die üblichen Verdächtigen:
- 0 und O, besonders in Variablennamen und Hexwerten
- 1, l und I, die sich in manchen Schriften nur um ein einziges Pixel unterscheiden
- Klammern:
{und(,]und), dazu spitze Klammern in Generics und HTML-Tags - Satzzeichen:
;und:,,und.sowie ein Backtick, der als gerades Anführungszeichen gelesen wird - Verschmolzene Buchstaben:
rnwird alsmgelesen oderclalsd - Unterstriche, die in Namen wie
user_idverschwinden oder zu Leerzeichen werden
Editorschriften mit Ligaturen zeichnen !=, => oder >= als ein einziges Symbol, das womöglich nicht als die Zeichen zurückgelesen wird, die du getippt hast. Stammt der Screenshot aus deinem eigenen Editor, schalte die Ligaturen vor der Aufnahme aus.
Am schnellsten prüfst du das Ergebnis, indem du den Code in einen Editor mit Linter oder Compiler einfügst. Klammern, die nicht zusammenpassen, und verirrte Zeichen fallen dann innerhalb von Sekunden auf.
Einrückung in Python und YAML prüfen
In Sprachen, in denen die Einrückung Bedeutung trägt, kann eine Zeile, die um eine Ebene verrutscht ist, trotzdem laufen – sie tut dann nur etwas anderes. Ein Linter findet das nicht immer. Vergleiche deshalb bei jedem Block, auf den es ankommt, die Verschachtelung mit dem Screenshot, etwa beim Rumpf einer Schleife oder bei einem verschachtelten Schlüssel in einer Konfigurationsdatei.
Klickst du im Ergebnis auf eine Zeile, leuchtet ihre Stelle im Bild auf. So siehst du schnell, wo eine Zeile wirklich beginnt. Ist ein ganzer Block verschoben, geht es meist schneller, ihn im Editor als Block einzurücken, als jede Zeile einzeln zu korrigieren.
Einen saubereren Screenshot aufnehmen
Oft bekommst du ein besseres Ergebnis, wenn du den Screenshot neu aufnimmst, statt hinterher Zeichen von Hand zu korrigieren:
- Zoom vor der Aufnahme hinein. Größerer Text hat mehr Pixel pro Zeichen, und das hilft vor allem bei Satzzeichen.
- Nimm nur den Code auf. Lass Seitenleisten, Tabs und die Minimap weg, damit sich nichts anderes unter deine Zeilen mischt.
- Schalte den Zeilenumbruch aus. Eine lange Zeile, die der Editor auf zwei Zeilen umbricht, wird als zwei Zeilen gelesen.
- Denk an Tabs und Leerzeichen. Ein Bild verrät nicht, was das Original verwendet hat. Nutzt dein Projekt Tabs, lass nach dem Einfügen deinen Formatter laufen.
Für Screenshots allgemein, auch von Chats und Fehlermeldungen, erklären die Seite Screenshot in Text und die Anleitung Text aus einem Screenshot extrahieren die Grundlagen. Ist der Code Teil einer längeren Dokumentseite, zeigt Bild in Markdown, wie du Fließtext und Code auf getrennte Screenshots aufteilst.