Bewahren Sie die rohe Konvertierung vor dem Bearbeiten
Behalten Sie das konvertierte Ergebnis als eigenes Dokument und bewahren Sie die Quelldatei auf, bis die Prüfung abgeschlossen ist. Das gibt Ihnen eine Referenz, wenn Text fehlt oder in falscher Reihenfolge erscheint, und verhindert, dass ein nicht zusammenhängender, ungespeicherter Entwurf überschrieben wird.
Nutzen Sie Undo nach automatisierten Bereinigungsaktionen und machen Sie jeweils nur eine Kategorie von Änderungen. Eine breite Umschreibung kann versehentlich beabsichtigte Leerzeichen im Code entfernen oder eine Listenverschachtelung ändern, die bereits korrekt war.
Entfernen Sie Extraktionsrauschen
PDF-Kopfzeilen, Seitenzahlen, wiederholte Fußzeilen, Folienbeschriftungen, leere Tabellenzeilen und doppelte Leerzeilen fügen häufig keine Bedeutung hinzu. Suchen Sie nach wiederholten Fragmenten und entfernen Sie sie konsequent, ohne dabei eine Formulierung zu löschen, die auch Teil des echten Inhalts ist.
- Ziehen Sie Folgen von drei oder mehr Leerzeilen außerhalb von Code-Blöcken zusammen.
- Führen Sie Wörter zusammen, die nur durch PDF-Zeilenumbrüche mit Silbentrennung getrennt sind.
- Löschen Sie Navigations- oder Rechts-Beiwerk, das auf jeder Seite wiederholt wird.
- Entfernen Sie leere Überschriften und leere Listeneinträge.
Bauen Sie eine logische Überschriften-Gliederung wieder auf
Verwenden Sie eine H1 für den Dokumenttitel. Hauptabschnitte verwenden in der Regel H2, Unterabschnitte H3 usw. Überspringen Sie keine Ebenen, nur um eine kleinere visuelle Gestaltung zu erreichen; die Darstellung gehört zum Renderer.
Konvertierte PDFs kennzeichnen fett formatierte Zeilen möglicherweise zu aggressiv als Überschriften, während Word-Dokumente mit manueller Formatierung sie möglicherweise gar nicht kennzeichnen. Lesen Sie die Gliederung wie ein Inhaltsverzeichnis und passen Sie die Ebenen anhand der Bedeutung an.
Before: # Deployment #### Prerequisites ## Linux After: # Deployment ## Prerequisites ### Linux
Normalisieren Sie Listen und Abstände
Verwenden Sie einen Marker-Stil für ungeordnete Einträge und einheitliche Einrückung für Verschachtelungen. Halten Sie vor und nach einer Liste eine Leerzeile, vermeiden Sie aber Leerzeilen zwischen jedem kurzen Eintrag, sofern nicht jeder Eintrag mehrere Absätze enthält.
Ein Konverter kann nummerierte Überschriften oder Tabellenzellen fälschlich für Listeneinträge halten. Vergewissern Sie sich, dass die nummerierte Reihenfolge Bedeutung trägt und nicht eine Seitenbeschriftung der Quelle widerspiegelt.
Vereinfachen Sie Tabellen für schmale Bildschirme und die Lesbarkeit der Quelle
Prüfen Sie, dass jede Zeile dieselbe Anzahl an Zellen hat und dass senkrechte Striche im Inhalt maskiert sind. Kürzen Sie ausführliche Kopfzeilen, verschieben Sie lange Erklärungen unter die Tabelle und trennen Sie nicht zusammenhängende Spaltengruppen.
Verbundene Zellen, verschachtelte Tabellen, Diagramme und Tabellenkalkulationsformeln haben keine zuverlässige Entsprechung in Markdown-Tabellen. Ersetzen Sie sie durch eine Liste, mehrere kleine Tabellen, eine Textzusammenfassung oder einen Link zu gepflegten Quelldaten.
Prüfen Sie Links, Bilder und Code
Relative Links aus HTML oder EPUB hängen von ihrem ursprünglichen Ort ab. Die PDF-Extraktion kann URLs teilen, und Office-Dokumente können Anzeigetexte enthalten, deren Ziel sich geändert hat. Öffnen Sie jeden wichtigen Link im endgültigen Zielsystem.
Fügen Sie beibehaltenen Bildern beschreibenden Alternativtext hinzu. Bestätigen Sie, dass markierter Code die richtige Sprache hat und dass Sonderzeichen nicht typografisch verändert wurden. Führen Sie kopierte Befehle niemals aus, bevor sie als nicht vertrauenswürdiger Inhalt geprüft wurden.
Beenden Sie mit Bedeutung, nicht mit Aussehen
Vergleichen Sie Namen, Daten, Mengen, Code und Entscheidungen mit der Quelle. Schreiben Sie Sätze um, die von Seitenposition, Folienbildern oder Tabellenfarben abhingen. Sehen Sie sich das Dokument dann in Desktop- und schmalen Breiten an, laden Sie die .md-Datei herunter und validieren Sie sie im Publishing-System.