docs

Features

Die Tour, gruppiert nach dem, was du gerade tust: Lesen, Reviewen, GitHub durchstöbern, Bearbeiten und Dokumente wieder herausbekommen. PullMark ist bewusst kein vollständiger Review-Client — es zeigt das Markdown einer Änderung; für den Code bleiben deine gewohnten Tools die richtigen.

Lesen

  • GitHub-getreues Rendering — Tabellen, Aufgabenlisten, Fußnoten, Alerts, aufklappbare <details>, Syntax-Highlighting, Mermaid-Diagramme und KaTeX-Mathe ($…$ / $$…$$), alles offline. Ein Absatz aus nur [toc] wird zu einem verlinkten Inhaltsverzeichnis; ==highlight==, ~sub~, ^sup^ rendern auch.
  • Klicken zum Inspizieren — Bilder, Diagramme und Blockformeln öffnen in einem Overlay mit Schwenken und Zoomen; Sichern unter… und Teilen exportieren genau das, was du gerade betrachtest (Diagramme als echtes SVG).
  • Lebende Dateien — Dokumente rendern neu, sobald irgendein Editor speichert; relative Bilder und Links lösen auf, und ein Klick auf einen Link zu einer anderen Markdown-Datei öffnet sie an Ort und Stelle (als Vorschau, wenn sie in einem offenen Ort liegt).
  • Navigation — die Gliederungs-Seitenleiste (⌥⌘O), ⌘F für die Suche auf der Seite, ⇧⌘F für die Suche über alle Dateien in der Seitenleiste und ⌘K Schnell öffnen für Überschriften, Dateien, PRs, zuletzt Geöffnetes — oder füg direkt einen Pfad oder eine GitHub-URL ein.
  • Blame auf Lesehöhe — eine stille Spalte der Autorschaft: ein Avatar pro Blockfolge, Hover zeigt den Commit, Klick öffnet die Zeilenhistorie. GitHubs Blame-API, wo die Datei auf GitHub liegt, sonst schlichtes git blame.
  • Lesekomfort — Themes, Inhaltsbreite, Zeilennummern (Einstellungen), Zoom wie im Browser, Hell/Dunkel, Vollbild und pro Dokument gemerkte Lesepositionen.

Pull Requests reviewen

  • Gerenderte Diffs — hinzugefügte, entfernte und geänderte Blöcke direkt in der gerenderten Seite hervorgehoben, wortgenaue Diffs, wo die Änderung klein genug ist, um Sinn zu ergeben, inline oder nebeneinander (⌥⌘L), dazu das rohe Quelltext-Diff (⌘2) und das finale Ergebnis (⌘3). Verschobene Absätze bekommen einen dezenten „verschoben“-Chip statt Rot-plus-Grün-Rauschen.
  • Review-Threads an Ort und Stelle — bestehende Kommentare erscheinen unter den Blöcken, die sie diskutieren; fahr über einen Block für Review beginnen, Einzelkommentar senden oder Vorschlag hinzufügen (und der Stift bearbeitet den Block als Suggestion). Reviews gehen mit Urteil raus — oder als ausstehendes Review zu GitHub.
  • Wo der PR steht — der Übersichts-Header zeigt die Review-Entscheidung (genehmigt, Änderungen angefordert, Review erforderlich), das Urteil jedes Reviewers als Avatare mit Badges, erwartete Reviewer daneben, und eine CI-Checks-Kapsel, die sich zur vollen Check-Liste öffnet — Laufzeiten, Required-Tags und ein Link zu den Logs jedes Checks. Alles aktualisiert sich leise jede Minute.
  • Die Unterhaltung, lesbar — eine chronologische Timeline auf der Übersicht: Kommentare und Review-Urteile in Reihenfolge, die Inline-Kommentare jedes Reviews unter seiner Zusammenfassung verschachtelt, mit der diskutierten Datei auf der Karte. Reaktionen, Bearbeiten und Löschen eigener Kommentare und das Kommentarfeld am Fuß der Timeline. Für alle an (Einstellungen ▸ Allgemein ▸ Reviewen klappt die Threads weg).
  • Bleibt aktuell — offene PRs werden jede Minute geprüft; ein Banner bietet Aktualisieren an, wenn der Branch sich bewegt, und deine Kommentar-Entwürfe überleben. Offline geschriebene Kommentare warten in der Queue und laden hoch, sobald es geht.
  • Review-Anfragen — PRs, die auf dein Review warten, in der Seitenleiste mit Ungelesen-Zahlen. PR-Bilder und repo-relative Links lösen am Commit des PRs auf.

GitHub, ohne den Browser

  • Markdown-Links öffnen in der App — klick einen github.com/…/blob/…-Link und PullMark rendert ihn (der erste Klick fragt; ⌘-Klick invertiert deinen Standard). Eine Herkunftsleiste pinnt owner/repo @ ref · path fest, mit einem Weg zurück zu GitHub.
  • Ganze Repos durchstöbern — lade den Markdown-Baum eines Repos unter Orte, wechsle Branches, vergleiche gegen andere Branches, sieh dir Blame an — private Repos nutzen die Zugangsdaten, die PRs schon nutzen, und nichts Geladenes berührt je die Platte.
  • Branches und Worktrees — lokale Checkouts tragen einen Branch-Chip; sein Menü öffnet Worktrees als eigene Orte und liest andere Branches remote. Lokal schlägt remote, wenn ein Worktree den Branch schon hat.

Bearbeiten und Committen

  • Bearbeiten an Ort und Stelle — der Stift eines Blocks (oder ⌘E fürs ganze Dokument) verwandelt Blöcke in Editoren mitten in der gerenderten Seite; ⌘↩ speichert, Esc bricht ab. Speichern ist dagegen abgesichert, dass sich die Datei darunter ändert, und versioniert für „Letzte Änderung zurücknehmen“.
  • Committen aus der App — ⌃⌘K öffnet das Commit-Sheet fürs Repo der Datei: Dateien wählen, Nachricht schreiben, optional pushen — mit einer Sicherung, bevor es direkt auf main geht.

Mit der Historie vergleichen

  • Jede Datei, jede Revision — der „Vergleichen“-Button der Toolbar (Uhr mit Chevron) difft die Arbeitsdatei gegen jeden ihrer letzten 25 Commits oder jeden lokalen oder Remote-Branch — gerendert, mit hervorgehobenen geänderten Wörtern, genau wie bei einem Pull Request. Ein dezenter Punkt auf dem Button heißt: Die Datei hat uncommittete Änderungen.
  • „Was habe ich gerade geändert?" — ein Menüpunkt (Darstellung → Mit letztem Commit vergleichen) oder ein Shell-Befehl (pullmark --diff file.md, siehe die CLI). Das Diff bleibt dran, während die Datei sich weiter ändert — sieh zu, wie die Änderungen eines Agenten hervorgehoben landen, während er speichert.

Dokumente herausbekommen

  • Export — PDF (eine durchgehende Seite) oder komplett in sich geschlossenes HTML; Share schickt das Dokument überallhin, wohin macOS kann.
  • Kopieren in zwei Geschmacksrichtungen — ⌘C ist Rich Text für Docs/Slack; ⌥⌘C ist das zugrunde liegende Markdown.
  • Drucken — ⌘P, bei 100 %, unabhängig vom Zoom.
  • Quick Look — die Leertaste im Finder zeigt Markdown mit PullMarks eigenem Rendering.

Eine Toolbar, die dir gehört

Rechtsklick auf die Toolbar — oder Darstellung → Symbolleiste anpassen… — öffnet die native Anpassungs-Palette: Zieh raus, was du nie benutzt, ordne den Rest neu, füge „Flexibler Zwischenraum“ hinzu. Jede Art von Ansicht behält ihre eigene Anordnung, gemerkt über Starts hinweg: eine lokale Datei, ein GitHub-Doc, eine Pull-Request-Datei und die PR-Übersicht sind getrennte Toolbars, und du passt jede an, während du drin bist — so wie das Verfassen-Fenster von Mail seine eigene Toolbar behält.

Über den Standardsatz hinaus hält die Palette Elemente bereit, die versteckt starten: einen Quelltext-Schalter für den rohen Quelltext, Einzoomen / Tatsächliche Größe / Auszoomen, den Inhaltsbreite-Picker, Randnotiz hinzufügen (solange das Feature an ist) und für GitHub-Docs Teilen — die github.com-Seite des Dokuments, nie ein roher Link — sowie Neu laden, das einen Branch neu auf seine aktuelle Spitze auflöst und für Dokumente, die an einem bestimmten Commit geöffnet wurden, deaktiviert bleibt — mit Begründung. Out of the box ändert sich nichts; die Palette hält den Rest. Die Toolbar listet die Elemente jeder Ansicht.

Alles Weitere

  • Fenster und Tabs — ⌘N öffnet ein unabhängiges Fenster; führe sie zu nativen Tabs zusammen. Externe Öffnungen landen im vordersten Fenster.
  • Der pullmark-Befehl — Dateien, Ordner und Worktrees aus jedem Terminal. Siehe Kommandozeile.
  • Standard-App-Kontrolle — mach PullMark mit einem Klick zum .md-Handler — und es merkt, wenn ein Update die Zuordnung verwirft.
  • Eingebaute Updates — signierte, notarisierte Releases mit Ein-Klick-Update und einem „Neuerungen“-Sheet.
  • Datenschutz-Haltung — GitHub-Inhalte kommen über die API und bleiben im Speicher, und Dokumente werden nie irgendwohin kopiert. Die Datenschutz-Seite hat die ganze Geschichte.