Sobald du einen KI-Agenten wie Claude Code oder Codex nutzt, füllt sich dein Computer mit „.md“-Dateien: die CLAUDE.md, in der du dem Agenten Anweisungen gibst, und dazu die Rechercheergebnisse und Arbeitspläne, die der Agent für dich schreibt. Das alles sind Textdateien in einem Format namens Markdown.
Doch per Doppelklick lässt sich eine .md-Datei oft nicht lesbar öffnen. In diesem Artikel stellen wir allen, die KI-Agenten nutzen, Markdocx vor, eine App für Mac und Windows zum Lesen und Bearbeiten von .md-Dateien.
KI-Agenten arbeiten mit .md-Dateien
Wenn du mit einem KI-Agenten arbeitest, dienen .md-Dateien zwei Zwecken: Anweisungen und Ergebnissen.
Anweisungen für den Agenten
Claude Code liest die CLAUDE.md jedes Mal, wenn es mit der Arbeit beginnt. Schreib dort deinen Arbeitsablauf, die Regeln, die eingehalten werden sollen, und deinen bevorzugten Schreibstil hinein, dann musst du nicht jedes Mal alles erklären.
| Datei | Gelesen von | Zweck |
|---|---|---|
| CLAUDE.md im Projektordner | Claude Code | Anweisungen für dieses Projekt. Mit dem Befehl /init lässt sich eine erste Version erstellen |
| ~/.claude/CLAUDE.md | Claude Code | Deine persönlichen Vorlieben, für alle Projekte |
| AGENTS.md | Codex (auch Claude Code kann sie lesen) | Anweisungen für das Projekt |
~/.claude ist ein versteckter Ordner in deinem Benutzerordner. Im Finder auf dem Mac blendest du versteckte Ordner mit Command + Shift + . (Punkt) ein.
Anweisungen schreibt man nicht einmal und vergisst sie dann. Du liest sie wieder, während du beobachtest, wie der Agent arbeitet, ergänzt sie und lässt sie wachsen.
Ergebnisse vom Agenten
Rechercheberichte, Arbeitspläne, Zusammenfassungen von Änderungen, README-Dateien: Auch die Ergebnisse der Arbeit, die du einem Agenten überträgst, kommen oft als .md-Dateien. Markdown kennzeichnet Überschriften, Listen und Tabellen mit Zeichen. Für eine KI ist das leicht zu schreiben, und Menschen können die Struktur gut erfassen. Wenn ein Agent einen Ablauf oder einen Aufbau erklärt, fügt er oft ein Diagramm in einem Format namens Mermaid ein.
Aber .md-Dateien sind schwer zu lesen
Eine .md-Datei ist Text, in dem Überschriften mit „#“, Fettdruck mit „**“ und Tabellen mit „|“ markiert sind. Erstaunlich wenige Apps zeigen das per Doppelklick sauber aufbereitet an.
- Auf dem Mac öffnet sie sich in einer App wie TextEdit mit all diesen Zeichen, oder es startet eine App für Entwickler
- Der Editor (Notepad) von Windows 11 kann inzwischen einfache Formatierungen wie Überschriften, Fettdruck und Listen anzeigen. Tabellen, farbig hervorgehobenen Code und Mermaid-Diagramme, die in den Ergebnissen eines Agenten häufig vorkommen, zeigt er aber nicht an
Um sie richtig zu lesen, musst du den Text in einen Webdienst kopieren oder in einem Entwickler-Editor eine Vorschau öffnen – ein Schritt mehr. Das bei jedem Bericht des Agenten zu tun, wird schnell lästig. Und wenn du die CLAUDE.md bearbeitest, schreibst du einen Text voller Zeichen um.
Mit Markdocx per Doppelklick lesen und direkt bearbeiten
Markdocx ist eine App für Mac und Windows, die eine .md-Datei gleich beim Öffnen als sauberes Dokument zeigt. Mach Markdocx zur App für .md-Dateien, und künftig genügt ein Doppelklick. Wie das geht, steht in unserem Artikel über eine App zum Öffnen von .md-Dateien.
Die Ergebnisse des Agenten als sauberes Dokument lesen
- Überschriften, Listen, Tabellen, Aufgabenlisten und Zitate werden sauber dargestellt, Code farblich nach Sprache hervorgehoben
- Mermaid-Diagramme erscheinen als Diagramme. Unterstützt werden 10 Arten, vom Flussdiagramm bis zum Sequenzdiagramm, und sie werden auf deinem Computer gezeichnet – du siehst sie also auch ohne Internetverbindung
- Die Überschriften stehen in der Gliederung links, so springst du in langen Berichten direkt an jede Stelle
CLAUDE.md bearbeiten und die Vorschau im Blick behalten
- Ordne Editor und Vorschau nebeneinander an. Was du tippst, erscheint sofort in der Vorschau, so prüfst du beim Ergänzen, wie deine Anweisungen unter den einzelnen Überschriften gegliedert sind
- Die Formatierungsleiste fügt Fett, Links, Tabellen, Listen und mehr ein – du musst dir nicht die ganze Markdown-Syntax merken
- Deine Arbeit wird automatisch gesichert, und eine .md-Datei bleibt eine .md-Datei. Der Agent liest deine bearbeitete CLAUDE.md oder AGENTS.md, wenn er das nächste Mal mit der Arbeit beginnt
Ergebnisse als Word oder PDF weitergeben
Manchmal möchtest du einen Bericht des Agenten an Kollegen oder Kunden weitergeben, die keine KI nutzen. Mit Markdocx exportierst du ihn über die Export-Taste in der Symbolleiste nach Word (.docx) oder PDF. Überschriften, Tabellen und Code bleiben erhalten, und Mermaid-Diagramme werden als Bilder eingebettet, sodass die Empfänger sie allein mit Word sehen können. Mehr dazu in unserem Artikel über Mermaid und den Export nach Word.
Lesen und Bearbeiten bleiben kostenlos
Markdocx gibt es im Mac App Store und im Microsoft Store. In den ersten 14 Tagen sind alle Funktionen kostenlos. Danach bleiben Öffnen, Lesen und Bearbeiten von .md-Dateien ohne Zeitlimit kostenlos. Ein Konto brauchst du nicht. Den Export nach Word, PDF und in andere Formate schaltest du mit einem Einmalkauf frei. Ein Abo gibt es nicht.
Die Mac-Version läuft ab macOS 26, die Windows-Version unter Windows 11 und Windows 10 (ab Version 1809).
