docs

Functies

De rondleiding, gegroepeerd naar wat je aan het doen bent: lezen, reviewen, GitHub verkennen, bewerken en documenten weer naar buiten krijgen. PullMark is bewust geen volledige reviewclient — het toont de Markdown in een wijziging; voor de code blijven je gebruikelijke tools de juiste.

Lezen

Rendering trouw aan GitHub — tabellen, takenlijsten, voetnoten, alerts, inklapbare <details>, syntaxkleuring, Mermaid-diagrammen en KaTeX-wiskunde ( $…$ / $$…$$), allemaal offline. Een alinea met alleen [toc] wordt een aanklikbare inhoudsopgave; ==highlight==, ~sub~ en ^sup^ renderen ook.
Klik om te inspecteren — afbeeldingen, diagrammen en losstaande formules openen in een pan-en-zoom-overlay; Bewaar als… en Deel exporteren precies wat je aan het bekijken bent (diagrammen als echte SVG).
Levende bestanden — documenten renderen opnieuw zodra ze vanuit welke editor dan ook worden opgeslagen; relatieve afbeeldingen en links werken, en een klik op een link naar een ander Markdown-bestand opent het ter plekke (als preview wanneer het in een open Locatie staat).
Navigatie — de outline-zijbalk (⌥⌘O), ⌘F zoeken op de pagina, ⇧⌘F zoeken door alle bestanden in de zijbalk, en ⌘K Open snel voor koppen, bestanden, PR's, recente items — of plak er direct een pad of GitHub-URL in.
Blame op leeshoogte — een rustige kantlijn van auteurschap: één avatar per reeks blokken, hover voor de commit, klik door voor de regelgeschiedenis. GitHubs blame-API waar het bestand op GitHub woont, gewoon git blame in alle andere gevallen.
Leescomfort — thema's, tekstbreedte, regelnummers (Instellingen), zoomen zoals in een browser, licht/donker, volledig scherm, en per document onthouden leesposities.

Pull requests reviewen

Gerenderde diffs — toegevoegde, verwijderde en gewijzigde blokken gemarkeerd in de gerenderde pagina, diffs op woordniveau waar de bewerking klein genoeg is om betekenis te houden, inline of side-by-side (⌥⌘L), plus de ruwe Bron-diff (⌘2) en het uiteindelijke Resultaat (⌘3). Verplaatste alinea's krijgen een rustige "verplaatst"-chip in plaats van rood-plus-groene ruis.
Reviewthreads op hun plek — bestaande comments verschijnen onder de blokken waar ze over gaan; hover over een blok voor Start een review, Voeg losse comment toe of Voeg een suggestie toe (en het potlood bewerkt het blok als suggestie). Reviews dien je in met een oordeel, of je bewaart ze op GitHub als pending review.
Waar de PR staat — de kop van het overzicht toont de reviewbeslissing (Goedgekeurd, Wijzigingen gevraagd, Review vereist), het oordeel van elke reviewer als avatars met badges en de nog verwachte reviewers ernaast, en een capsule met CI-checks die openklapt naar de volledige checklijst — duur, Vereist-labels en een link naar de logs van elke check. Alles ververst stilletjes elke minuut.
De conversatie, leesbaar — één chronologische tijdlijn op het overzicht: comments en review-oordelen op volgorde, de inline comments van elke review genest onder haar samenvatting, met het besproken bestand bij naam op de kaart. Reacties, bewerken en verwijderen van je eigen comments, en het commentaarvak onderaan de tijdlijn. Aan voor iedereen (Instellingen ▸ Algemeen ▸ Reviewen stopt de threads weg).
Blijft actueel — open PR's worden elke minuut gecontroleerd; een banner biedt verversen aan wanneer de branch beweegt, en je conceptcomments blijven bewaard. Offline geschreven comments komen in de wachtrij en uploaden zodra het kan.
Reviewverzoeken — PR's die op jouw review wachten, in de zijbalk met ongelezen-tellers. PR-afbeeldingen en repo-relatieve links worden opgelost op de commit van de PR.

GitHub, zonder de browser

Markdown-links openen in de app — klik op een github.com/…/blob/…-link en PullMark rendert hem (de eerste klik vraagt het; ⌘-klik keert je standaard om). Een herkomstbalk pint owner/repo @ ref · pad vast, met een weg terug naar GitHub.
Blader door hele repo's — laad de Markdown-boom van een repo in Locaties, wissel van branch, vergelijk met andere branches, bekijk blame — privérepo's gebruiken de credentials die PR's al gebruiken, en niets van wat wordt opgehaald raakt ooit de schijf.
Branches en worktrees — lokale checkouts dragen een branch-chip; het bijbehorende menu opent worktrees als eigen Locaties en leest andere branches op afstand. Lokaal wint altijd van remote wanneer een worktree de branch al heeft.

Bewerken en committen

Ter plekke bewerken — het potlood van een blok (of ⌘E voor het hele document) verandert blokken in editors binnen de gerenderde pagina; ⌘↩ slaat op, Esc annuleert. Opslaan is bewaakt tegen een bestand dat onder je verandert, en geversioneerd voor Draai laatste bewerking terug.
Committen vanuit de app — ⌃⌘K opent het commitpaneel voor de repo van het bestand: kies bestanden, schrijf het bericht, push desgewenst mee, met een waarschuwing voordat je rechtstreeks naar main commit.

Vergelijken met de geschiedenis

Elk bestand, elke revisie — de Vergelijk-knop in de toolbar (de klok met chevron) difft het werkbestand met elk van zijn laatste 25 commits, of met elke lokale of remote branch — gerenderd, met de gewijzigde woorden gemarkeerd, precies zoals bij een pull request. Een subtiele stip op de knop betekent dat het bestand niet-gecommitte wijzigingen heeft.
"Wat heb ik net veranderd?" — één menu-item (Weergave → Vergelijk met laatste commit) of één shellcommando (pullmark --diff file.md, zie de CLI). De diff blijft bij terwijl het bestand verandert — zie de bewerkingen van een agent landen, gemarkeerd, bij elke save.

Documenten naar buiten krijgen

Exporteren — PDF (één doorlopende pagina) of volledig zelfstandige HTML; Deel stuurt het document overal heen waar macOS het kan bezorgen.
Kopiëren in twee smaken — ⌘C is opgemaakte tekst voor Docs/Slack; ⌥⌘C is de onderliggende Markdown.
Afdrukken — ⌘P, op 100% ongeacht je zoomniveau.
Quick Look — de spatiebalk in de Finder toont Markdown-previews met PullMarks eigen rendering.

Klik met de rechtermuisknop op de toolbar — of Weergave → Pas toolbar aan… — voor het native aanpaspalet: sleep eruit wat je nooit gebruikt, herschik de rest, voeg Flexibele ruimte toe. Elk soort weergave houdt zijn eigen indeling bij, onthouden tussen sessies: een lokaal bestand, een GitHub-doc, een pull request-bestand en het PR-overzicht zijn aparte toolbars, en je past elk aan terwijl je erin zit — net zoals het opstelvenster van Mail zijn eigen toolbar houdt.

Naast de standaardset bevat het palet items die verborgen beginnen: een ruwe-Bron-schakelaar, Zoom in / Werkelijke grootte / Zoom uit, de Tekstbreedte-kiezer, Voeg margin note toe (zolang de functie aanstaat), en voor GitHub-docs Deel — de github.com-pagina van het document, nooit een ruwe link — en Herlaad, dat een branch opnieuw oplost naar zijn huidige punt en uitgeschakeld blijft, mét de reden, voor documenten die op een specifieke commit zijn geopend. Uit de doos verandert er niets; het palet bewaart de rest. De toolbar somt de items van elke weergave op.

Al het andere

Vensters en tabbladen — ⌘N opent een onafhankelijk venster; voeg samen tot native tabbladen. Externe opens landen in het voorste venster.
Het pullmark-commando — bestanden, mappen en worktrees vanuit elke terminal. Zie Command line.
Regie over de standaardapp — maak PullMark met één klik de handler voor .md, en de app merkt het als een upgrade de koppeling laat vallen.
Ingebouwde updates — ondertekende, genotariseerde releases met een éénkliksupdate en een Wat is er nieuw-paneel.
Privacyhouding — GitHub-inhoud wordt via de API opgehaald en in het geheugen gehouden, en documenten worden nooit ergens naartoe gekopieerd. De privacypagina vertelt het hele verhaal.