Markdown-Formatter
Räume Markdown mit diesem Markdown-Formatter auf. Füge ein README, eine Dokumentationsseite oder Notizen ein. Das Werkzeug entfernt führende und nachgestellte Leerzeilen und richtet jede Pipe-Tabelle neu aus: Zellen werden auf die breiteste Zelle ihrer Spalte gebracht und die Trennzeile mit passenden Bindestrichen neu erstellt, wobei die Ausrichtung durch Doppelpunkte erhalten bleibt. Alles andere bleibt wie geschrieben. So erhalten Autoren und Entwickler übersichtliche Tabellen ohne Überraschungen.
Häufig gestellte Fragen
Was ändert der Markdown-Formatter?
Er richtet Pipe-Tabellen neu aus und entfernt Leerzeilen und Leerzeichen am Anfang und Ende des Dokuments. Überschriften, Absätze, Listen, Links und Hervorhebungen bleiben genau so, wie du sie geschrieben hast.
Wie werden Tabellen formatiert?
Jede Zeile erhält eine Pipe am Anfang und am Ende. Jede Zelle wird mit Leerzeichen auf die Breite der breitesten Zelle ihrer Spalte gebracht; Spalten sind mindestens drei Zeichen breit. Die Trennzeile wird mit Bindestrichen derselben Breite neu erstellt.
Bleiben die Spaltenausrichtungen erhalten?
Ja, Doppelpunkte in der Trennzeile bleiben erhalten. Die mit :---, :---: und ---: festgelegte linksbündige, zentrierte und rechtsbündige Ausrichtung bleibt bei der Neuformatierung bestehen.
Werden Tabellen in Codeblöcken geändert?
Nein, alles zwischen Zäunen aus drei Backticks oder drei Tilden bleibt unverändert. Dazu gehört auch Text in Codeblöcken, der wie eine Tabelle aussieht.
Warum wirken Spalten mit Akzentbuchstaben oder Emojis falsch ausgerichtet?
Zellbreiten werden in UTF-8-Bytes gemessen, daher zählen Zeichen außerhalb von ASCII jeweils zwei bis vier Bytes. Spalten mit solchen Zeichen können in einem einfachen Texteditor zusätzliche Abstände haben; die Darstellung der Tabelle bleibt davon unberührt.
Ändert der Formatter Listenmarker oder Überschriftenstile?
Nein, Listenmarker, Nummerierung, Überschriftenmarker und Abstände innerhalb von Absätzen bleiben wie geschrieben. Der Formatter ist bewusst zurückhaltend, damit sich die Darstellung deines Dokuments nie ändert.
Wird das formatierte Dokument anders dargestellt?
Nein, das Auffüllen der Tabellenzellen und das Entfernen der äußeren Leerzeilen des Dokuments ändern die Darstellung nicht. GitHub, GitLab und andere Renderer zeigen die Tabellen davor und danach gleich an.
Kann ich das für MDX-Dateien verwenden?
Ja, aber der MDX-Formatter eignet sich besser, weil er das Ergebnis als mdx kennzeichnet. Beide wenden dieselben Regeln an und lassen Imports und JSX unverändert.
Warum ist das Ergebnis in einen Markdown-Codeblock eingeschlossen?
Die Ausgabe wird in einem mit markdown gekennzeichneten Codeblock zurückgegeben und beim Einfügen in einen Markdown-Viewer als Quelltext angezeigt. Kopiere die Zeilen zwischen den äußeren Zäunen in deine .md-Datei.
Wie groß darf mein Dokument sein?
Bis zu 5 MB pro Durchlauf; größere Eingaben werden mit einer Meldung abgelehnt. Die Ausgabe entspricht der Option Markdown des Code Formatters.