Text as Code mit Markdown & Git

10 Minuten Lesedauer
Text as Code mit Markdown & Git

Unser Student Devin speichert seine Arbeiten in einer Cloud mit Dateiversionierung und sichert sie zusätzlich nach der 3-2-1-Regel ab. Das ist praktisch, denn wenn etwas schiefgeht, kann er in der Regel auf eine frühere Version zurückspringen.

Trotzdem gibt es einen noch größeren Vorteil, wenn man Texte als Markdown und mit Git verwaltet: Man sieht auf einen Blick, was sich zwischen zwei Versionen geändert hat. Statt sich durch unübersichtliche Dokumentkopien zu kämpfen, kann Devin Änderungen gezielt nachvollziehen, besprechen und bei Bedarf wieder zurücknehmen.

Dazu kommt, dass sich so viel besser im Team arbeiten lässt. Mehrere Personen können gleichzeitig an unterschiedlichen Dateien oder Kapiteln arbeiten, ohne ständig an einer einzigen, chaotischen Dokumentversion zu hängen.

In diesem Beitrag zeigen wir, wie Devin mit dem Konzept "Text as Code" einen robusten und kollaborativen Workflow für Texte aufbaut.

Markdown & Plain Text

Eine .docx-Datei von Word sieht von außen aus wie ein einzelnes Dokument, ist intern aber ein komplexer ZIP-Ordner voller verschachtelter XML-Daten, Formatierungsanweisungen und Medien. Kippt hier auch nur ein einziges Byte um, weigert sich das Programm oft komplett, die Datei zu lesen.

Die Lösung? Plain Text (reiner Text).

Reiner Text ist das robusteste und zukunftssicherste Format der Welt. Eine .txt-Datei, die 1995 geschrieben wurde, kannst du heute noch auf fast jedem Gerät problemlos öffnen. Keine Kompatibilitätsprobleme, kein Vendor-Lock-in durch Software-Abos.

Aber reiner Text ist hässlich? Nicht mit Markdown. Markdown (.md) ist eine einfache Auszeichnungssprache. Anstatt mit der Maus einen Text zu markieren und auf "Fett" zu klicken, tippst du einfach zwei Sternchen um das Wort: **fett**. Aus einem # wird eine große Überschrift. Es bleibt eine reine Textdatei, wird aber von modernen Editoren (wie Obsidian, Typora oder Zettlr) in Echtzeit wunderschön formatiert dargestellt.

Git für Text

Wenn du deine Dokumente als reinen Text speicherst, öffnet sich plötzlich das Tor zu den mächtigsten Werkzeugen der Softwareentwickler. Das wichtigste davon heißt Git.

Git ist ein Versionskontrollsystem. Es speichert nicht einfach alle paar Minuten die ganze Datei neu, sondern arbeitet intelligent:

1. Commits (Meilensteine)

Anstatt unzählige Kopien deiner Arbeit zu speichern (hausarbeit_v1.md, hausarbeit_neu.md), hast du nur noch eine Datei. Immer wenn du einen Sinnabschnitt fertig hast (z.B. "Kapitel 2 abgeschlossen"), erstellst du einen sogenannten Commit. Ein Commit ist ein fester Meilenstein, zu dem du jederzeit zurückkehren kannst. Du gibst jedem Commit eine kurze Beschreibung mit, sodass du später genau weißt, wann du was gemacht hast.

2. Diffs (Was hat sich geändert?)

Das Gute an Git und Markdown ist die Ansicht der Unterschiede zwischen zwei Versionen. Git vergleicht zwei Versionen deines Textes zeilenweise und zeigt dir visuell an, was sich geändert hat:

- Ich schreibe gerne Hausarbeiten in Word.
+ Ich schreibe gerne Hausarbeiten in Markdown.

Rot und mit Minus markiert ist der alte Text, Grün und mit Plus markiert ist der neu hinzugekommene Text. Bei einer .docx-Datei sieht Git oft nur einen riesigen, unlesbaren Haufen Buchstabensalat. Nur bei reinem Text kann es dir diese präzisen Änderungen zeigen.

Einfache GUIs (Graphical User Interfaces)

Devin fühlt sich bei einem schwarzen Terminal mit grünem Text nicht besonders wohl. Das Gute ist: Er muss das Terminal für Git überhaupt nicht anfassen.

Dank Graphical User Interfaces (GUIs) ist die Versionskontrolle heute auch für Einsteiger gut nutzbar:

1. Obsidian + Git Plugin einrichten

Obsidian speichert Notizen und Hausarbeiten als lokale Markdown-Dateien. Genau das ist praktisch, weil sich dieser Ordner später direkt mit Git verbinden lässt.

Bevor du loslegst, sollte Git auf deinem Rechner installiert sein. Eine gute Anleitung findest du hier: Git installieren.

Danach gehst du in Obsidian Schritt für Schritt so vor:

  1. Neuen Vault anlegen: Beim ersten Start von Obsidian legst du einen Vault an. Das ist einfach der Ordner, in dem deine Notizen und Texte gespeichert werden. Wichtig ist: Wähle am besten direkt einen passenden Speicherort, denn genau in diesem Ordner wird später auch das Git-Repository angelegt.

  2. Leeren Ordner auswählen: Am einfachsten ist es, wenn du dafür einen neuen, leeren Ordner nimmst. Obsidian speichert dann alle Dateien dort ab, und Git kann diesen Ordner später sauber überwachen.

  3. Community Plugins öffnen: In Obsidian gehst du unten links auf die Einstellungen, dann auf Community Plugins und deaktivierst bei Bedarf zuerst den sicheren Modus, damit du Plugins installieren kannst.

  4. Richtiges Plugin suchen: Über Browse suchst du nach Obsidian Git. Anschließend installierst und aktivierst du das Plugin. Obsidian Git Plugin

  5. Git-Repository im Vault anlegen: Jetzt musst du den Vault noch mit Git verbinden. Das geht in der Regel einmalig mit git init direkt im Vault-Ordner oder über eine grafische Oberfläche wie GitHub Desktop. Dadurch wird der Ordner zu einem Git-Repository. Jetzt solltes du in Obsidian die Möglichkeit haben, Commits zu erstellen und deine Änderungen zu verfolgen. Das sieht dann ungefähr so aus: Git Status

  6. Mit einem Server verbinden: Anschließend kannst du das lokale Repository mit einem entfernten Server verbinden, zum Beispiel mit Forgejo auf einem Raspberry Pi oder mit GitHub bzw. GitLab.

git remote add origin https://dein-server.com/username/repository.git

  1. Automatische Sicherung einschalten: Zum Schluss stellst du ein, dass das Plugin regelmäßig einen neuen Commit erstellt und die Änderungen automatisch auf den Server hochlädt. Automatische Sicherung

    So sieht der unsichtbarer Workflow nun aus:

%%{init: { 'theme': 'base'}}%%
graph LR
    Local[Devins Laptop<br>Obsidian Editor] -->|Auto Commit & Push| Server[(Remote Git-Server<br>z.B. Gitea/GitHub)]
    Server -.->|Pull bei Bedarf| Other[Anderes Gerät<br>Handy / Zweit-PC]

    %% Design-Optimierungen (Farben & Formen)
    style Local fill:#f9f9f9,stroke:#333,stroke-width:1px
    style Server fill:#cce5ff,stroke:#004085,stroke-width:2px,rx:10px,ry:10px
    style Other fill:#f9f9f9,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5

Das Praktische daran: Danach läuft vieles automatisch. Du kannst per Hotkey oder Zeitplan sichern lassen, und das Plugin erledigt den Rest im Hintergrund. Im Alltag musst du dafür keine kryptischen Terminal-Befehle eingeben.

2. GitHub Desktop

Wer nicht alles direkt im Texteditor machen will, kann sich GitHub Desktop installieren. Das Programm ist anfängerfreundlich: Links siehst du deine geänderten Dateien, in der Mitte die Unterschiede zwischen den Versionen und unten rechts ein Feld, in das du kurz "Fazit hinzugefügt" einträgst und dann auf "Commit" klickst.

Fazit

Seit Devin "Text as Code" für sich entdeckt hat, schreibt er seine Arbeiten nur noch in Markdown und versioniert sie mit Git. Egal, ob der Laptop ausfällt, der Texteditor abstürzt oder er versehentlich 10 Seiten löscht: Seine Versionen bleiben sicher und nachvollziehbar erhalten. Das Format gehört ihm, nicht Microsoft, und er kann jederzeit genau nachvollziehen, an welchen Sätzen er zuletzt gearbeitet hat. Mit Hilfe von Pandoc kann er seine Markdown-Dateien sogar problemlos in PDF oder Word umwandeln, wenn es doch mal nötig sein sollte.

Quellen & Weitere Infos