Vergleich28. Oktober 20268 Min. Lesezeit

Bester AsciiDoc-Editor 2026: kostenlos, online, für Mac und iPad

Asciidoctor lokal einzurichten kostet Zeit. Diese kostenlosen Editoren zeigen AsciiDoc mit Live-Vorschau, im Browser, auf dem Mac und auf dem iPad.

Read this in English

AsciiDoc ist bei vielen Teams für technische Dokumentation gesetzt: ausdrucksstärker als Markdown, mit includes, Querverweisen, Callouts und komplexen Tabellen. Der Haken ist das Werkzeug. Für eine lokale Vorschau braucht man Asciidoctor, dafür Ruby, und dafür eine funktionierende Ruby-Umgebung. Wer nur kurz prüfen will, wie ein Abschnitt aussieht, für den ist das zu viel.

Die gute Nachricht: Browser-Editoren für AsciiDoc sind inzwischen ausgereift. Dieser Vergleich zeigt die besten kostenlosen Optionen 2026, online, auf dem Mac und auf dem iPad, und wofür sich welche eignet.

Worauf es bei einem AsciiDoc-Editor ankommt

  • Genaue Darstellung: Die Vorschau sollte dem entsprechen, was Asciidoctor tatsächlich erzeugt. Manche Tools verschlucken Admonitions, Callouts oder Attribute.
  • Diagramme: Technische Dokumentation enthält oft Architekturdiagramme. Unterstützung für PlantUML, Mermaid und andere Kroki-Formate ist wichtig.
  • Import aus GitHub oder GitLab: Eine Datei direkt per URL zu laden spart Zeit, wenn man prüfen will, wie Inhalte aus einem Pull Request aussehen.
  • Export: PDF und HTML helfen, eine Vorschau mit Personen ohne Zugang zum Repository zu teilen.
  • Datenschutz: Bei internen Dokumenten macht es einen Unterschied, ob der Inhalt im Browser bleibt oder an einen Server geht.

1. AsciiDoc Alive: der beste Online-Editor mit Live-Vorschau

AsciiDoc Alive ist ein Browser-Editor auf Basis von Asciidoctor.js. Links schreiben, rechts die gerenderte Seite sehen, mit synchronem Scrollen.

Besonders praktisch ist der Import aus GitHub und GitLab: Datei-URL einfügen, und das Dokument ist geladen. AsciiDoc Alive unterstützt außerdem Kroki-Diagramme und MathJax und exportiert nach PDF, HTML und AsciiDoc.

Geeignet für: Technische Redakteurinnen und Redakteure, die beim Schreiben schnell eine Vorschau brauchen, und alle, die prüfen wollen, wie eine Datei vor dem Pull Request aussieht.

Grenzen: Keine Unterstützung für Dokumente, die aus mehreren Dateien per include:: zusammengesetzt sind.

Datenschutz: Läuft komplett im Browser. Es werden keine Inhalte an einen Server gesendet.

AsciiDoc Alive kostenlos öffnen

2. VS Code mit AsciiDoc-Erweiterung

Wer lokal arbeitet, bekommt mit der AsciiDoc-Erweiterung für VS Code eine Vorschau, Syntaxhervorhebung und Kroki-Diagramme. Gerendert wird mit Asciidoctor.js, die Ausgabe entspricht also der Build-Pipeline.

Geeignet für: Alle, die ohnehin in VS Code arbeiten, auch bei Dokumenten mit includes.

Grenzen: Setzt eine lokale Installation voraus. Für Fachleute ohne Entwicklungsumgebung ungeeignet.

3. GitLab Web IDE

Liegt die Dokumentation in GitLab, bietet die Web IDE eine eingebaute AsciiDoc-Vorschau. .adoc-Datei öffnen und die Vorschau einblenden.

Grenzen: Nur für GitLab-Repositories, kein Export, keine Diagramme in der Vorschau.

4. GitHub.dev

github.dev ist VS Code im Browser. Markdown-Vorschau ist eingebaut, AsciiDoc nicht. Die Erweiterung lässt sich installieren, funktioniert im Browser aber nur eingeschränkt.

5. DraftView: AsciiDoc aus GitHub und GitLab im Browser bearbeiten

DraftView ist vor allem ein Review-Tool, bringt aber einen schlanken AsciiDoc-Editor im Browser mit. Nichts installieren, keine lokale Umgebung.

Ausprobieren: Eine öffentliche Datei-URL aus GitHub oder GitLab in den DraftView-Editor einfügen. Kostenlos, und anmelden muss man sich erst, wenn man den Pull Request abschickt.

DraftView löst include::-Direktiven automatisch auf und zeigt alle eingebundenen Dateien in einer Seitenleiste, sodass man sie an einem Ort bearbeiten kann. Bearbeitet wird visuell oder im Quelltext. Danach erstellt DraftView einen Fork und öffnet einen Pull Request auf GitHub oder einen Merge Request auf GitLab.

Geeignet für: Schnelle Textkorrekturen direkt im Browser, ohne lokalen Klon und ohne Ruby.

Grenzen: Ein schlanker Editor, keine vollständige Entwicklungsumgebung. Kein globales Suchen und Ersetzen, kein Terminal.

Bester AsciiDoc-Editor für den Mac

Alle Browser-Tools oben laufen auch auf dem Mac. Wer täglich AsciiDoc schreibt, möchte aber oft etwas Installiertes. Diese kostenlosen Optionen lohnen sich unter macOS:

  • VS Code mit AsciiDoc-Erweiterung: die verbreitetste Wahl. Live-Vorschau, includes und Kroki-Diagramme in einem Editor, den viele schon nutzen.
  • IntelliJ IDEA mit dem AsciiDoc-Plugin: funktioniert in der kostenlosen Community Edition. Stark bei großen Dokumentationsprojekten aus vielen Dateien, mit Live-Vorschau und Navigation über includes und Querverweise.
  • AsciidocFX: ein kostenloses Open-Source-Schreibprogramm speziell für AsciiDoc, mit Live-Vorschau und Export nach PDF, HTML und EPUB.
  • AdocEditor: ein nativer AsciiDoc-Editor für macOS mit Live-Vorschau, für den privaten Gebrauch kostenlos.

Ohne Installation läuft AsciiDoc Alive in Safari oder Chrome auf jedem Mac.

AsciiDoc-Editor für das iPad

Eine überzeugende native AsciiDoc-App für das iPad gibt es nicht. Viele Texteditoren öffnen zwar .adoc-Dateien, stellen sie aber nicht so dar wie Asciidoctor. Admonitions, includes und Attribute erscheinen dann als Rohtext.

Auf dem iPad ist ein Browser-Editor in Safari der praktische Weg:

  • AsciiDoc Alive zum Schreiben und für die Vorschau. Asciidoctor.js läuft im Browser, die Vorschau entspricht also dem Build. Im Querformat hat die geteilte Ansicht genug Platz.
  • DraftView, wenn die Datei schon auf GitHub oder GitLab liegt. Datei-URL einfügen, visuell oder im Quelltext bearbeiten und die Änderung als Pull Request zurückschicken, ganz ohne lokalen Klon.

IDE oder Schreibprogramm?

Eine IDE passt zu allen, die auch mit Code arbeiten und große Projekte aus vielen Dateien pflegen. Ein reines Schreibprogramm konzentriert den Bildschirm auf Text und Vorschau.

Editor Art Läuft auf Live-Vorschau Kosten
VS Code + AsciiDoc-Erweiterung Code-Editor (IDE) macOS, Windows, Linux Ja Kostenlos
IntelliJ IDEA + AsciiDoc-Plugin IDE macOS, Windows, Linux Ja Kostenlos (Community Edition)
AsciidocFX Schreibprogramm macOS, Windows, Linux Ja Kostenlos, Open Source
AdocEditor Schreibprogramm macOS, Windows, Linux Ja Privat kostenlos
AsciiDoc Alive Browser-Editor Jeder Browser, auch iPad Ja Kostenlos

Die Online-Tools im Überblick

Tool Diagramme Import aus GitHub/GitLab Export Nur Browser
AsciiDoc Alive Ja (Kroki) GitHub und GitLab PDF, HTML Ja
VS Code + Erweiterung Ja (Kroki) Nein Über CLI Nein
GitLab Web IDE Nein Nur GitLab Nein Ja
GitHub.dev Eingeschränkt Nur GitHub Nein Ja
DraftView Nein GitHub und GitLab Nein Ja

Nach der Vorschau: das Review

Vorschau-Tools lösen das Schreiben und Prüfen. Ist der Pull Request offen, kommt das nächste Problem: das Review.

Die wichtigsten Prüfenden, etwa Fachexpertinnen, Produktmanager oder die Rechtsabteilung, haben oft kein GitHub-Konto. GitHub zeigt AsciiDoc zwar im Pull Request an, aber kommentieren geht nur mit Konto, und ein Diff aus AsciiDoc-Quelltext ist für sie schwer zu lesen.

Hier setzt DraftView an. Aus dem Pull Request wird ein Review-Link. Die Prüfenden öffnen ihn im Browser, lesen die gerenderte Dokumentation und kommentieren direkt im Text, ohne GitHub-Konto und ohne Quelltext. Ihr Feedback landet als native Suggested Changes im Pull Request, und das Team entscheidet, was übernommen wird. Mehr dazu im Leitfaden zu Docs-as-Code-Reviews (Englisch).

Liegt Ihre AsciiDoc-Datei auf GitHub? Hier direkt bearbeiten.

Datei-URL einfügen, und DraftView öffnet sie im visuellen Editor, mit allen includes. Danach wird Ihre Änderung als Pull Request verschickt, und Ihr Team kann ihn ohne GitHub-Konto prüfen.

AsciiDoc-Datei kostenlos bearbeiten

Zum Bearbeiten kein Konto nötig. Anmelden erst beim Absenden des Pull Requests.

Ressourcen