Ein gespeichertes Dokument als Word herunterladen
Das Download-Menü eines gespeicherten Dokuments bietet jetzt eine .docx an, an Ort und Stelle aus demselben HTML gebaut, das die Vorschau bereits anzeigt. Kein Browser im Hintergrund — es braucht vorher ein Speichern, denn die Konvertierung läuft auf der Kopie im Konto.
Ein gespeichertes Dokument lässt sich als .docx herunterladen, gebaut aus demselben HTML, das die Vorschau ohnehin zeigt. Word, Pages, LibreOffice und Google Docs öffnen es als gewöhnliches Dokument — Überschriften sind Word-Überschriften, Tabellen sind Word-Tabellen, Listen verschachteln sich, und Code behält seine Festbreitenschrift.
Was die Reise übersteht
Überschriften eins bis sechs, Absätze, Fett und Kursiv, geordnete und ungeordnete Listen samt ihrer Verschachtelung, Tabellen mit ihrer Kopfzeile, Blockzitate, Trennlinien, Links mit ihrem Text und ihrer Adresse und eingezäunter Code. Was nicht: alles, was es nur in einem Browser gibt — eine lebende Einbettung, ein aufklappbarer Abschnitt, ein Mermaid-Diagramm, das nie zu einem Bild gerendert wurde.
Bilder von fremden Adressen bleiben absichtlich draußen. Ein Konverter, der jedes Bild holt, das ein Dokument erwähnt, ist ein Konverter, der eine Anfrage an jede Adresse stellt, die der Autor des Dokuments gewählt hat — und der Handel, ein Bild gegen einen Server, der Fremden hinterherläuft, lohnt sich nicht.
Warum vorher gespeichert werden muss
Die Konvertierung läuft auf der Kopie des Dokuments im Konto, und die liest der Endpunkt für den Download. Eine Datei zu konvertieren, die Sie gerade erst abgelegt haben, ist Sache des Browsers und hat mit dem Konto überhaupt nichts zu tun; .docx ist die eine Richtung, die es doch hat.
Die andere Richtung
Legen Sie eine .docx auf den Konverter, wird sie zurück nach Markdown gelesen — Überschriften, Tabellen, Listen und alles —, und das ist der Weg, den die meisten tatsächlich wollen: ein Word-Dokument aus dem Postfach einer Kollegin, nach Markdown, in ein Repository.
Aus einem Skript
GET /api/v1/documents/:id.docx liefert mit einem API-Schlüssel dieselbe Datei — für einen Build, der Dokumentation als Word veröffentlicht, für Leute, die sie so haben wollen.
Weiter: Markdown nach Word, ausführlich und eine .docx zurück nach Markdown lesen.