docs
Settings
Everything behind ⌘, — four tabs: General for behavior, Appearance for how PullMark looks, Keyboard for the key map, and Experimental for features still settling. The window reopens on whichever tab you used last.
General
Reading this where PullMark (0.28.1+) is installed? Open the General tab.
Reading
| Setting | Options · default | What it does |
|---|---|---|
| Restore files and pull requests from the last session | on/off — on | Reopens what was in the sidebar when PullMark last quit — files, folders, PRs, browsed repos, and the preview entry (still as a preview). |
| Show hidden files | on/off — off | Dotfiles and hidden folders in Locations — .github/
docs and friends. Also toggled with ⇧⌘. (Finder's own
combo) or View → Show Hidden Files; every open Location rescans
on the flip. |
| GitHub Markdown links | Ask on first click · Open in PullMark · Open in Browser — Ask on first click | What clicking a link to a Markdown file on GitHub does. Hold ⌘ while clicking for the other behavior. The first-click dialog's "Remember my selection" checkbox sets this for you. |
| Clicking files in Locations | Preview First · Open Fully — Preview First | Preview First shows a file with one click without keeping it — one italicized entry (in Open Files, or under its GitHub repo) that the next preview replaces; double-click or start editing to keep it. Open Fully keeps every file you click. Applies to local folders and browsed GitHub repos alike. See Previews. |
Reviewing
| Setting | Options · default | What it does |
|---|---|---|
| Default diff layout | Inline · Side by Side — Inline | How PR rendered diffs open. Flippable per file with ⌥⌘L. |
| Show review requests in the sidebar | on/off — on | The Review Requests subgroup: open PRs where your review is requested. Hidden either way when you're not signed in. |
| Only requests that change Markdown | on/off — on | Hides review requests with no Markdown files — PullMark has nothing to show for them. |
| Show review discussion on the PR overview | on/off — on | Inline review threads nested under their review in the overview's conversation — every thread, including files PullMark doesn't render, with the commented passage alongside. Off shows verdicts and comments only. Graduated from Experimental in 0.34. |
GitHub
| Setting | What it does |
|---|---|
| Connection | Whether PullMark can talk to GitHub, as whom, and through
which credential source ("Connected as you · GitHub CLI").
Check Again re-reads credentials — after
gh auth login it connects without a relaunch —
and Set Up… opens a walkthrough that detects
what this Mac is missing. See
GitHub access
for the full credential story. |
Updates
| Setting | What it does |
|---|---|
| Show What's New after an update | On (the default) presents the release notes after an update lands; off swaps in a quiet "Updated to PullMark X" banner with the notes one click away — an update always announces itself somehow. |
| Updates | Check for Updates… on demand; PullMark also checks at launch and periodically. When an update is already known, the row offers What's New, Update Now, and a re-check button right there. What's New shows the notes of every release between your version and the new one, and Help → Release Notes has the full history any time. |
System
| Setting | What it does |
|---|---|
| Default Markdown app | Shows which app currently opens .md files;
Make PullMark the Default claims the binding in
one click. If a later upgrade makes macOS drop it, PullMark
notices and offers to take it back. |
| Command line | Installs the pullmark
command into /usr/local/bin for DMG installs
(Homebrew users already have it). Shows a checkmark when a
pullmark is already on your PATH. |
| Quick Look previews | Rendered (the default) or Raw Source — what pressing Space in Finder shows for Markdown files. |
Appearance
Reading this where PullMark (0.28.1+) is installed? Open the Appearance tab.
The Light · Dark · System switch sits at the top — the whole app follows, chrome and rendered pages alike (each theme brings its own light and dark looks). Below it, the visual options:
Every choice here is a card with a live preview rendered through the real pipeline — what you see is what documents get.
Theme ↗
| Theme | Look |
|---|---|
| GitHub (default) | The classic look, exactly as on github.com. |
| Editorial | Bookish serif headers on warm paper. |
| Terminal | Monospace with a phosphor-green accent. |
Custom themes: drop .css files into
the Themes folder (button in this tab) and they appear as cards. They
apply on top of the GitHub look, follow the Light/Dark appearance, and
restyle diffs too. Quick Look previews follow your theme (custom
themes fall back to their GitHub base there).
Content width ↗
| Choice | Meaning |
|---|---|
| Standard (default) | A classic book-like reading measure. |
| Wide | Longer lines, more on screen — still caps the line length. |
| Full Width | Text uses the whole window — handy in full screen. |
Applies everywhere, live, and composes with themes, blame, diffs, and zoom. Also switchable mid-read from View → Content Width.
Line numbers ↗
| Choice | Meaning |
|---|---|
| Hidden (default) | A clean margin; numbers on demand in the Source view. |
| Shown | Each block's starting source line in the margin of rendered documents and diffs — hover a number for the block's full range. Numbering is per block, not per visual line (rendered text wraps freely). The raw source view always shows its own line numbers. |
Keyboard
Reading this where PullMark (0.28.1+) is installed? Open the Keyboard tab.
Every menu action's shortcut is rebindable — see Keyboard Shortcuts for the full map and how recording, conflicts, and Restore Defaults work.
Experimental
Reading this where PullMark (0.28.1+) is installed? Open the Experimental tab.
Features that ship before their design is settled, each labeled beta or alpha — the levels contract explains what each promises. Alpha features stay hidden until you turn on Show alpha features (a dialog explains the alpha terms first), and every feature has its own enable switch. Margin notes lives here — beta since 0.35 and on by default, with its enable switch, author setting, and a Copy button for the agent-instructions snippet; the first use introduces the feature and offers to turn it off.
Where things are stored
All preferences live in the app.pullmark.PullMark
defaults domain. Sessions, reading positions, and drafts are metadata
only — PullMark never copies your documents anywhere, and content
fetched from GitHub stays in memory.