adoc Studio vs Craft

Craft

Eine plattformübergreifende Notiz- und Dokumenten-App. Für persönliches Wissensmanagement, Team-Notizen und kreative Dokumente.

adoc Studio

AsciiDoc-basiertes Schreibprogramm für technische Dokumentation wie Handbücher, Whitepapers und Entwickler-Guides.

Feature-Vergleich

Funktion	Craft	adoc Studio
Plattform-Verfügbarkeit	★ Mac, iOS, Windows, Android, Web überall	Nur Apple-Geräte (macOS, iOS, iPadOS)
Benutzerfreundlichkeit	★ WYSIWYG-Editor mit Drag & Drop	Text-Editor mit AsciiDoc-Syntax lernen
Echtzeit-Zusammenarbeit	★ Mehrere Personen arbeiten gleichzeitig	Nur dateibasierte Zusammenarbeit (Git)
Strukturierte Dokumentation	Unterseiten & Ordner, manuell organisiert	★ Multi-File-Projekte mit automatischen Includes
Content-Wiederverwendung	Manuelle Block-Kopierung zwischen Seiten	★ Automatische Includes & globale Variablen
Publishing-Kontrolle	Feste Themes, begrenzte Anpassung	★ Vollständige CSS-Kontrolle über Layout

Schreib-Philosophie

Craft

Visuelle Flexibilität: WYSIWYG-Editor mit Styling und Drag-and-Drop-Blöcken.

adoc Studio

Strukturierte Präzision: AsciiDoc-Markup mit semantischer Struktur, Live-Vorschau und Syntax-Hilfe.

Plattform-Verfügbarkeit

Craft

Universeller Zugriff: Verfügbar auf iOS, macOS, Windows, Android und Web.

adoc Studio

Exklusiv für Apple: Native Apps für macOS, iPad und iPhone mit tiefer Integration ins Apple-Ökosystem.

Inhaltsorganisation & Wiederverwendung

Craft

Visuelle Organisation: Unterseiten, Ordner und blockbasierte Inhalte mit manuellem Kopieren zwischen Dokumenten. Gut für flexible, kreative Inhaltsorganisation.

adoc Studio

Modulare Architektur: Include-Direktiven und Attribute für echtes Single-Source-Publishing. Einmal schreiben, überall wiederverwenden.

Ansatz zur Zusammenarbeit

Craft

Echtzeit-Teamarbeit: Live-Sync, teilbare Links und Slack-Integration. Cloud-first-Plattform, bei der Teammitglieder sofort die neueste Version sehen.

adoc Studio

Versionskontroll-Workflow: Dateibasierte Zusammenarbeit über Git oder iCloud-Sharing. Keine Echtzeitbearbeitung, aber transparente Änderungsverfolgung und Merge-Funktionen.

Wann welches Tool wählen?

Craft für...

Plattformübergreifende Verfügbarkeit
Visuelles WYSIWYG-Editing
Echtzeit-Zusammenarbeit
Aufgabenverwaltung und Kalenderintegration

Ideal für:

Persönliches Wissensmanagement
Team-Brainstorming und Meeting-Notizen
Plattformübergreifende Teamarbeit

adoc Studio für...

Strukturierte technische Dokumentation
Projekte mit mehreren Kapiteln
Single-Source Publishing
Versionskontroll-Integration mit Git

Ideal für:

Software-Dokumentation und API-Guides
Technische Handbücher und Anleitungen
Forschung & Akademisches Arbeiten

Von Craft zu adoc Studio

Die Migration von Craft zu adoc Studio umfasst die Konvertierung von visuellen, blockbasierten Inhalten in strukturierte AsciiDoc-Markups. Der Übergang erfordert das Erlernen einer neuen Syntax, eröffnet jedoch leistungsstarke Funktionen für die technische Dokumentation.

Export aus Craft

Exportieren Sie Ihre Dokumente als Markdown (.md) oder TextBundle (inkl. Medien). Für größere Migrationen können Sie ganze Ordner exportieren. Das TextBundle-Format fasst Inhalte und Bilder in einem Paket zusammen.

Markdown in AsciiDoc umwandeln

Konvertieren Sie exportierte Dateien mit Pandoc:

pandoc -s doc.md -t asciidoc -o doc.adoc

Import in adoc Studio

Erstellen Sie ein neues Projekt und organisieren Sie die Inhalte:

Kopieren Sie .adoc-Dateien in den Projektordner
Speichern Sie Bilder aus dem TextBundle im Media-Ordner
Passen Sie Bildreferenzen zu image::media/filename.png[] an
Nutzen Sie Includes für die Projektstruktur

Inhalte prüfen und verbessern

Optimieren Sie Ihre Texte mit dem “adoc Coach”:

Wandeln Sie Craft-Callouts in Admonitions um
Überführen Sie Umschaltbereiche in AsciiDoc
Korrigieren Sie Tabellen, Fußnoten und Codeblöcke
Überprüfen Sie die HTML/PDF-Vorschau

Styling anpassen

Ersetzen Sie Craft-Themes durch CSS-Styling in adoc Studio. Nutzen Sie ein integriertes Theme oder Ihr eigenes CSS. Ein Stylesheet steuert HTML- und PDF-Ausgaben einheitlich.

Erweiterte Funktionen nutzen

Nutzen Sie die erweiterten Möglichkeiten von adoc Studio:

Bedingte Abschnitte für unterschiedliche Zielgruppen
Attribute für wiederverwendbare Inhalte
Git-Repository für Versionskontrolle
Export-Produkte für verschiedene Formate

Häufig gestellte Fragen

Kann ich meine Craft-Dokumente nach adoc Studio migrieren?

Ja, die Migration ist über den Markdown-Export von Craft und die Umwandlung nach AsciiDoc mit Pandoc möglich. Die grundlegende Inhaltsstruktur wird gut übertragen, aber Crafts visuelle Elemente (benutzerdefinierte Blöcke, erweiterte Layouts) müssen in AsciiDoc neu erstellt werden. Für textlastige Dokumente ist der Prozess unkompliziert, bei komplexen visuellen Layouts sind manuelle Anpassungen erforderlich.

Wie unterscheiden sich die Kollaborationsfunktionen?

Craft bietet überlegene Echtzeit-Zusammenarbeit mit Live-Sync, teilbaren Links und Team-Workspaces auf allen Plattformen. adoc Studio nutzt dateibasierte Zusammenarbeit über Git oder iCloud-Sharing ohne Echtzeitbearbeitung. Craft ist besser für sofortige Team-Kollaboration; adoc Studio ist besser für strukturierte, versionskontrollierte Dokumentations-Workflows.

Welches Tool eignet sich besser für technische Dokumentation?

adoc Studio ist speziell für technische Dokumentation entwickelt – mit Syntax-Hervorhebung für Codeblöcke, Admonitions (NOTE/TIP/WARNING), Querverweisen und strukturierten Autorentools. Craft unterstützt einfache Code-Formatierung und Einbettungen, bietet aber keine spezialisierten Funktionen für technisches Schreiben. Für ernsthafte technische Dokumentation ist adoc Studio die klare Wahl.

Wie sieht es mit Plattform-Verfügbarkeit und Vendor-Lock-in aus?

Craft läuft auf allen großen Plattformen (iOS, macOS, Windows, Android, Web), speichert Inhalte jedoch in einem proprietären Format, das regelmäßige Exporte für Portabilität erfordert. adoc Studio läuft nur auf Apple-Plattformen, speichert jedoch alles als offene AsciiDoc-Plaintext-Dateien ohne Vendor-Lock-in. Die Wahl hängt von den Plattform-Anforderungen im Vergleich zu langfristiger Portabilität ab.

Welches Tool ist besser für Inhaltswiederverwendung und Pflege?

adoc Studio überzeugt bei Inhaltswiederverwendung mit AsciiDoc-Includes und Attributen für Single-Source-Publishing. Änderungen werden automatisch an allen Referenzen übernommen. Craft erfordert manuelles Kopieren von Blöcken zwischen Dokumenten ohne automatische Updates. Für große Dokumentationsbestände mit wiederkehrenden Inhalten ist die Automatisierung von adoc Studio unschätzbar.

Kann ich beide Tools in meinem Workflow nutzen?

Ja, viele Nutzer kombinieren die Stärken beider Tools. Craft für Brainstorming, Meeting-Notizen und kollaboratives Entwerfen (insbesondere mobil oder mit nicht-technischen Teammitgliedern) und anschließend adoc Studio für strukturierte technische Dokumentation und professionelles Publishing. Jedes Tool unterstützt unterschiedliche Phasen des Content-Lifecycles.