Excel zu Markdown: vom Tabellenblatt zur Pipe-Tabelle
Ein Excel-Bereich kopieren und in eine Markdown-Datei einfügen funktioniert fast – bis das Blatt verbundene Zellen, breite Formelspalten oder drei Arbeitsblätter statt eines hat. Die Text-Tabelle ist in Notepad lesbar, bricht aber, wenn Sie sie in GitHub, Obsidian oder ein Wiki einfügen, weil der Konverter die Struktur nicht verstanden hat.
Dieser Artikel erklärt, was eine xlsx-zu-Markdown-Konvertierung wirklich tut: wie man jedes Arbeitsblatt behält, verbundene Bereiche in echte Zellen auflöst, Datums- und Zahlenformate beibehält, die Excel selbst anzeigt, und auf GFM-Pipe-Tabellen landet, die überall rendern. Alles läuft in Ihrem Browser – kein Upload, kein Konto, kein Server in Ihrer Arbeitsmappe.
Tabellenblatt und Markdown-Tabelle sind nicht dasselbe
Eine xlsx-Arbeitsmappe ist ein ZIP aus XML. Darin liegen mehrere Arbeitsblätter, jedes ein rechteckiges Raster aus Zellen. Eine Zelle kann leer sein, einen String, ein als Seriennummer gespeichertes Datum, eine Formel oder einen formatierten Wert wie 1.240,50 enthalten. Zellbereiche können zu einer sichtbaren Zelle verbunden werden. Die Struktur hat Layout, Formeln und Anzeige-Metadaten, für die Markdown-Tabellen einfach keinen Platz haben.
Eine Markdown-Pipe-Tabelle – die GFM-Form, die GitHub, Obsidian und die meisten Wikis rendern – hat zwei Zeilen Metadaten und pro Datenzeile eine Zeile, jede mit gleich vielen Spalten. Keine verbundenen Zellen, keine Formeln, kein Layout. Die Aufgabe eines Konverters ist die Übersetzung zwischen diesen Welten: das Raster in Zeilen auflösen und jede Zelle mit dem Wert füllen, den Excel auf dem Bildschirm zeigt.
Jedes Arbeitsblatt exportieren, nicht nur das erste
Die meisten Quick-Tools exportieren nur das aktive Blatt und lassen den Rest still liegen. Eine echte Konvertierung geht jedes Arbeitsblatt durch, überspringt völlig leere und gibt jedes als eigene Markdown-Tabelle aus – mit dem Blattnamen als Überschrift der Ebene 2 darüber. So landet Ihre Arbeitsmappe als einziges Markdown-Dokument, das die ursprüngliche Struktur widerspiegelt.
Die Standardeinstellung auf dieser Seite lautet „alle Blätter“; Sie können aber auch „nur das erste Blatt“ aus den Arbeitsblattoptionen wählen, wenn Sie nur eins wollen. Leere Blätter und Blätter mit nur Überschriften werden automatisch herausgefiltert, damit kein h2 ohne darunterliegende Tabelle entsteht.
Verbundene Zellen: das unsichtbare Problem
Verbundene Zellen sind der größte Grund für kaputte Tabellen beim Kopieren und Einfügen. Wenn Excel A1:D1 zu einer sichtbaren Zelle verbindet, hat das zugrunde liegende Raster trotzdem vier Zellen – nur A1 enthält den Wert, B1 bis D1 sind leer. Ein naiver Konverter gibt vier Spalten aus, drei davon leer, was die Zeilenanzahl zerstört und eine Tabelle erzeugt, die kein Markdown-Parser korrekt rendert.
Die Lösung heißt Auflösung: SheetJS liefert uns jeden verbundenen Bereich in der Arbeitsmappe, bevor wir die Tabelle bauen. Wir kopieren den Wert der oberen linken Zelle in jede andere Zelle dieses Bereichs, damit das Raster, das wir an Pandoc übergeben, keine Lücken hat. Die resultierende Pipe-Tabelle hat so viele Zellen wie das sichtbare Raster von Excel, jede Zeile passt, die Tabelle rendert sauber.
Datum, Währung, Zahlen: zeigen Sie, was Excel zeigt
Excel speichert Datumsangaben als Seriennummern – 46095 bedeutet 15. Januar 2026. Rohe Zahlen sind in Markdown nutzlos, aber ein Konverter, der mit beliebigen Regeln neu formatiert, vertauscht leicht Datumsangaben (ist die Zelle 1/2 oder 2/1?). Die einzige vertrauenswürdige Quelle ist der Text, den Excel selbst anzeigt, den SheetJS mit der Option raw:false direkt liest.
Währung, Prozent, Dezimalstellen, Tausendertrennzeichen – alles kommt als der Text durch, den Sie in der Formelleiste sehen. 1.240,50 bleibt 1.240,50, 0,12 bleibt 12 %, wenn Excel es so angezeigt hat, und 15.01.2026 bleibt genau das, statt still auf 2026-01-15 umformatiert zu werden.
Formeln versus Werte
Excel-Zellen können entweder eine Formel (=SUMME(A1:A10)) oder ihren berechneten Wert (1240,50) enthalten. Markdown-Tabellen können nur Werte halten. Einige Konverter versuchen, die Formelsyntax zu behalten, was außerhalb von Excel selten nützt. Wir lesen den berechneten Wert – die Zahl oder den Text, den Excel nach Auswertung der Formel anzeigen würde – und geben diesen aus. Wenn Sie die Formeln selbst brauchen, exportieren Sie die Arbeitsmappe zuerst nach CSV; dieser Konverter ist für das lesbare Ergebnis da, nicht für die Berechnung.
Breite Tabellen und was man damit macht
Ein Arbeitsblatt mit fünfzehn Spalten konvertiert problemlos – Pandoc gibt eine vollständige, gültige Pipe-Tabelle aus. Ob sie gut aussieht, hängt davon ab, wo Sie sie lesen. Die meisten Markdown-Renderer wickeln Pipe-Tabellen natürlich um; Obsidian, GitHub und Hugo kommen mit Breiten gut zurecht. Für Ziele, die das nicht tun, teilen Sie die Arbeitsmappe vor der Konvertierung in schmalere Blätter, oder akzeptieren Sie, dass eine breite Tabelle die ehrliche Darstellung ist und der Renderer horizontal scrollen soll.
Was wir nicht tun, ist still Spalten löschen oder Daten zusammenbrechen. Die Tabelle, die herauskommt, ist genau das Raster aus der Arbeitsmappe – keine Überraschungen, keine fehlenden Spalten.
Warum zwei Engines: SheetJS liest, Pandoc formatiert
Diese Seite nutzt SheetJS Community Edition zum Parsen der Arbeitsmappe und übergibt die resultierende HTML-Tabelle dann an Pandoc, um Markdown (GFM) auszugeben. SheetJS kümmert sich um die kniffligen Excel-Interna – verbundene Bereiche, Datumsreihen, Anzeigeformate, das ZIP-Paket selbst. Pandoc kümmert sich um die kniffligen Markdown-Dialekte – Pipe-Tabellensyntax, Ausrichtungshinweise und die endgültige CommonMark-Konformität.
Beides im Browser bedeutet: nichts berührt einen Server. Die SheetJS-Bibliothek wird nur dann heruntergeladen, wenn Sie tatsächlich eine xlsx-Datei ablegen, und Pandoc ist seit Ihrer ersten Nutzung des Konverters bereits im Tab vorhanden. Die gesamte Bearbeitungszeit für eine typische Arbeitsmappe mit mehreren Blättern liegt unter zehn Sekunden.