Merkzeug
In Entwicklung · Erste App-Store-Version in Vorbereitung

Dein Markdown. Im Zusammenhang.

Durchsuche, verbinde und bearbeite Markdown-Sammlungen – vom persönlichen Notizbuch bis zur Dokumentation deiner Coding-Agenten.

Finde dich in einer Sammlung von Dateien zurecht. Folge Links, lies Diagramme und bearbeite Inhalte visuell. Deine Notizen bleiben in den Ordnern und Repositories, zu denen sie gehören.

Der Gedanke hinter dem Namen

Ein Werkzeug fürs Merken.

Merken + Werkzeug = Merkzeug. Für Gedanken, die du festhalten, wiederfinden und weiterentwickeln möchtest. Aus vielen Markdown-Dateien wird eine Sammlung, in der du dich zurechtfindest.

Ein Werkzeug. Zwei Ausgangspunkte.

Dein persönliches Notizbuch

Gedanken, Projekte und Meeting-Notizen bilden eine Sammlung, die mit dir wächst. Nutze einen Ordner als Notizbuch, verknüpfe seine Notizen und halte ihren Kontext im Frontmatter fest. Dafür brauchst du kein Git-Repository.

Dein Repository als Wissenssammlung

READMEs, Architekturentscheidungen, Pläne und Agenten-Dokumentation liegen bereits neben deinem Code. Navigiere und bearbeite sie dort, wo sie sind. Links und integrierte Diagramme machen ihre Zusammenhänge sichtbar.

Merkzeug ist ein Lese- und Bearbeitungswerkzeug für deine Markdown-Sammlungen. Es erzeugt selbst keine Dokumentation und führt keinen Coding-Agenten aus.

Entwicklungsvorschau von Merkzeug auf dem Mac mit erfundenen Notizen
Entwicklungsvorschau von Merkzeug auf dem Mac mit erfundenen Notizen

Klar schreiben

Überschriften, Listen, Aufgaben, Tabellen und Bilder — visuell bearbeiten, als Markdown speichern.

Gedanken verbinden

Verknüpfe Notizen und stelle Abläufe als Mermaid-Diagramme dar. Deine Ordner bleiben deine Struktur.

Als PDF teilen

Auf dem Mac exportierst du eine Notiz oder verknüpfte Notizen mit wiederverwendbaren PDF-Vorlagen.

Vom Repository zum lesbaren Zusammenhang

Deine Agenten schreiben Markdown. Du erkennst den Zusammenhang.

Architekturübersichten, Umsetzungspläne, Recherchen und Projektübergaben gehören zum Code. Merkzeug macht sie angenehm lesbar.

Öffne den Dokumentationsordner deines Repositorys, folge Verweisen zwischen Notizen und lies Mermaid-Diagramme direkt im Dokument. Überschriften, Tabellen und Aufgabenlisten geben erzeugten Markdown-Dateien eine klare Struktur. Prüfe das Ergebnis, ergänze Erklärungen und behalte deinen gewohnten Git-Workflow.

Zum Beispiel: Starte mit einer Übersicht, folge dem Link zu einer Architekturentscheidung, sieh dir das eingebettete Ablaufdiagramm an und exportiere am Desktop die Übersicht samt ausgewählten verlinkten Notizen als PDF.

Mac-Entwicklungsvorschau mit einem Mermaid-Ablaufdiagramm in einer Projektnotiz
Das Diagramm ist Teil der Notiz. Mac-Entwicklungsvorschau mit erfundenen Beispieldaten; Bild anklicken für die volle Größe.

Änderungen mit Git festhalten.

Der Git-Bereich am Desktop zeigt den aktuellen Branch und geänderte Dateien und bietet Commit, Push und Pull. Auf iPhone und iPad übernimmt Working Copy die Git-Aktionen, während Merkzeug die gemeinsamen Dateien bearbeitet.

Git-Bereich mit dem Branch main, einer geänderten Markdown-Datei und Aktionen für Commit, Push und Pull
Mac · Geänderte Dateien sehen und Git direkt im Notizbuch verwenden. Der Screenshot zeigt ein lokales Demo-Repository.

PDF-Export & Vorlagen · Desktop und IntelliJ-Vorschau

Aus Arbeitsnotizen werden Dokumente zum Weitergeben.

Eine Notiz. Oder mehrere verknüpfte Dokumente.

Exportiere eine einzelne Notiz oder hänge direkt verlinkte Markdown-Dokumente aus ihrer Ordnerhierarchie an. Verweise auf enthaltene Dokumente werden zu PDF-Sprungzielen. Ergänze ein anklickbares Inhaltsverzeichnis und einen eigenen Titel für das gemeinsame Dokument.

Mermaid-Diagramme werden vor dem Export gerendert. Breite Tabellen lösen eine Ausgabe im Querformat aus. Am Desktop kannst du auch mehrere ausgewählte Notizen als einzelne PDFs exportieren.

Ein wiederverwendbares Layout pro Projekt.

Gestalte Vorlagen mit Deckblatt, Logo, Kopf- und Fußzeilen, CSS und Seitenrändern. Füge Dokumenttitel, Datum und Seitenzahlen ein. Am Desktop ordnest du einem Notizbuch eine Vorlage zu; in IntelliJ wählst du einen Vorlagenordner für das Projekt.

Vorlagen sind gewöhnliche Dateien und lassen sich mit Git versionieren. Der PDF-Export läuft lokal. Auf iPhone und iPad ist er noch nicht verfügbar.

Was gehört in eine PDF-Vorlage?

Eine Vorlage ist ein Ordner mit diesen optionalen Dateien:

  • deckblatt.html — Deckblatt
  • kopfzeile.html und fusszeile.html — Kopf- und Fußzeile
  • stil.css — Dokumentgestaltung
  • vorlage.json — Seitenränder

Lege Logos im selben Ordner ab und verweise mit relativen Bildpfaden darauf. {{titel}} und {{datum}} setzen Titel und Exportdatum ein.

PDF-Export und Vorlagen im Desktop-Handbuch kennenlernen →

PDF-Vorlagen-Einstellungen mit einer dem Demo-Notizbuch zugewiesenen Projektbericht-Vorlage
Mac · Eine wiederverwendbare PDF-Vorlage für dein Notizbuch auswählen. Screenshot in voller Größe öffnen.

Frontmatter

Gib deinen Notizen Kontext.

Strukturierte Metadaten stehen am Anfang deiner Markdown-Datei. Klappe den Frontmatter-Bereich auf, bearbeite YAML und ergänze Felder für Titel, Tags oder eigene Projektinformationen.

Auch die Exporteinstellungen bleiben beim Dokument: pdf-linked-title benennt das gemeinsame PDF, pdf-toc aktiviert sein Inhaltsverzeichnis, pdf-exclude lässt ausgewählte verlinkte Notizen aus und language bestimmt die Sprache der Inhaltsüberschrift.

---
title: Systemübersicht
tags: [architektur, review]
status: entwurf
pdf-linked-title: Projekthandbuch
pdf-toc: true
language: de
---

Ein Beispiel, das du in Git versionieren, in jedem Texteditor lesen und mit anderen Werkzeugen verwenden kannst.

Geöffneter Frontmatter-Editor mit Titel, Tags und Sprache über einer Markdown-Notiz
Mac · Strukturierte Metadaten direkt bei der zugehörigen Notiz bearbeiten.

Kalender-Integration · macOS & klassisches Outlook unter Windows

Vom Termin zur Meeting-Notiz.

Wähle einen Termin aus deinen lokal eingerichteten Kalendern. Merkzeug erstellt eine benannte Notiz mit Datum, Uhrzeit, Ort, Organisator, Teilnehmenden und erkanntem Meeting-Link im Frontmatter. Im Text warten eine Anwesenheits-Checkliste und Abschnitte für Agenda, Notizen und Aufgaben.

Am Mac werden die Konten der Kalender-App verwendet, darunter iCloud, Exchange und Google. Windows nutzt klassisches Outlook; das neue Outlook wird nicht unterstützt. Der Kalenderzugriff benötigt eine Freigabe. Auf iOS, iPadOS und Linux ist die Kalender-Integration derzeit nicht verfügbar.

Kalenderauswahl über einer Besprechungsnotiz mit Teilnehmern, Agenda und Aufgaben
Mac · Aus einem Kalendertermin wird eine Besprechungsnotiz. Fiktive Termine und Teilnehmer.

Git-Repositories auf iPhone & iPad

Dein Repository. Auch unterwegs.

Nutze Working Copy für Git und Merkzeug zum Lesen und Bearbeiten. Über die iOS-Dateiauswahl arbeiten beide mit demselben Repository-Ordner.

  1. In Working Copy klonen. Richte dort dein Remote-Repository ein und hole die aktuellen Änderungen.
  2. Den Ordner in Merkzeug öffnen. Tippe auf „Vault-Ordner öffnen“, navigiere zu Working Copy und wähle das Repository oder seinen Notizordner.
  3. Lesen, Links folgen und bearbeiten. Notizen öffnen sich im Lesemodus; der Stift aktiviert das Bearbeiten. Änderungen werden automatisch im gewählten Ordner gespeichert.
  4. In Working Copy committen und pushen. Prüfe dort die Änderungen und synchronisiere sie. Kehre nach einem Pull zu Merkzeug zurück oder aktualisiere den Ordner. Löse Konflikte, bevor du weiterbearbeitest.

Merkzeug führt auf iOS selbst keine Git-Operationen aus. Working Copy ist eine separate App mit eigenen Funktions- und Kaufbedingungen. Alternativ kannst du Notizen aus iCloud Drive oder einem anderen kompatiblen Anbieter der Dateien-App öffnen.

Zum Handbuch für iPhone und iPad →

iPad-Entwicklungsvorschau mit einer Projektnotiz und ihrem eingebetteten Mermaid-Diagramm
Verknüpfte Projektnotizen und Diagramme auf dem iPad lesen. Entwicklungsvorschau mit erfundenen Beispieldaten.

Auf Mac, iPhone und iPad zu Hause

Oberfläche und integrierte Hilfe auf Deutsch und Englisch. PDF-Export gehört zur Desktop-Version; iPhone und iPad konzentrieren sich auf die Bearbeitung deiner Dateien. Eine IntelliJ-Editor-Vorschau ist ebenfalls in Entwicklung.

Die erste Version ist kostenlos geplant, ohne Abonnement und ohne In-App-Käufe.

Coming soon

Windows · Linux · IntelliJ · VS Code

Geplant sind Desktop-Versionen für Windows und Linux sowie Editor-Integrationen für IntelliJ und VS Code. Für IntelliJ gibt es bereits einen funktionsfähigen Prototyp mit PDF-Export. Termine und öffentliche Downloads kündigen wir hier an.

Deine Sammlung dabei

Dein Notizbuch. Auch unterwegs.

Öffne einen Ordner über die Dateien-App auf iPhone und iPad. Bearbeite deine Notizen dort, wo du sie brauchst. Dateianbieter wie iCloud Drive oder Working Copy kümmern sich um die Synchronisierung.

Zur iPhone- und iPad-Hilfe →
Merkzeug auf dem iPhone mit fiktiven Notizen

Gut zu wissen

Einfach anfangen.

Brauche ich ein Konto?

Nein. Merkzeug bearbeitet Dateien in einem Ordner deiner Wahl.

Wo bleiben meine Notizen?

In deinem ausgewählten Ordner als Markdown-Dateien. Sichere diesen Ordner regelmäßig. Ein Cloud-Dateianbieter kann ihn entsprechend deinen Einstellungen synchronisieren.

Kann ich schon herunterladen?

Die erste Store-Version wird vorbereitet. Sobald sie verfügbar ist, findest du hier die offiziellen Download-Links. Die Erstversion ist kostenlos und enthält keine In-App-Käufe.

Auf welchen Plattformen gibt es PDF-Export?

Desktop und IntelliJ bieten PDF-Export. Auf iPhone und iPad steht die Bearbeitung im Vordergrund; PDF-Export ist dort noch nicht verfügbar.

Was als Nächstes kommt

Ein Werkzeug, das weiterwächst.

Unsere nächsten Schritte, kurz und verständlich. Pläne können sich ändern; feste Veröffentlichungstermine sind damit nicht verbunden. Jeder Eintrag verlinkt das zugehörige GitHub-Ticket.

In Prüfung & Test

  • Erste App-Store-VersionmacOS · iOS#17

Geplant

  • Helle & dunkle DesignsAlle Editionen#18
  • IntelliJ-PluginIntelliJ#19
  • Windows-DownloadsWindows#20 #21
  • Linux-PaketeLinux#22
  • Meeting-Notizen auf iPhone & iPadiOS · iPadOS#36
  • PDF-Vorlagen zum LoslegenDesktop#30
  • Vorlagen-Design beim BearbeitenDesktop#35
  • Working-Copy-AktioneniOS · iPadOS#25
  • Weitere KalenderquellenAlle Editionen#24
  • Bessere Hinweise für Coding-AgentenVaults & Repositories#23

In Evaluierung

  • Weitere iOS-Git-ClientsiOS · iPadOS#26

Zuletzt abgeglichen: · Vollständige Roadmap auf GitHub

Release Notes

Was sich in Merkzeug tut.

Version 1.0 für Mac, iPhone und iPad wird vorbereitet. Hier findest du die Inhalte der ersten Version; veröffentlichte Updates kommen hinzu, sobald sie verfügbar sind.

Release Notes lesen