docs

The toolbar

One toolbar per kind of view, each fully customizable: right-click it (or View → Customize Toolbar…) and drag items out, rearrange them, add what starts hidden. Each view remembers its own arrangement across launches.

How customization works

PullMark doesn't have one toolbar — it has one per kind of view, the way Mail's compose window keeps a different toolbar than its main window. You customize the toolbar you're looking at: open a pull request file to customize the PR-file toolbar, a local document to customize the local-file toolbar. The palette only ever offers the items that exist where you opened it.

Everything in the palette is fair game — remove it, reorder it, drop in Flexible Space to push clusters apart. Items marked hidden below start in the palette rather than the bar. The one place items won't go is the sidebar's own strip next to the sidebar toggle: that section belongs to the system, and a drop there settles at the front of the main section instead. Restore any toolbar by dragging the default set back in from the bottom of the palette.

On every view

Item	Default	What it does
Back/Forward	shown	Back and forward through every document you've viewed — click and hold either arrow for its history.
Review	shown	The morphing review control, on PR views only — pending comment count, verdict, submit. Survives a narrow window longest: review status stays visible when other items collapse into the overflow.
Open File or Folder	shown	Open local Markdown or a folder Location.
Open Pull Request	shown	Open a GitHub pull request by URL.
Appearance	shown	Light · Dark · System, app-wide.

Local files

Item	Default	What it does
Share	shown	The standard share sheet for the file.
Edit	shown	Edit mode — click any block to edit in place.
Compare	shown	Compare with a commit or branch (needs a git repository). A small dot means the file has uncommitted changes.
Blame	shown	Who last changed each block; disabled outside a repository.
Outline	shown	The headings sidebar.
Reload	shown	Re-read the file from disk.
Source	hidden	The raw Markdown behind the rendered page.
Zoom In · Actual Size · Zoom Out	hidden	Separate items — add just the pair you use.
Content Width	hidden	Standard · Wide · Full Width.
Add Margin Note	hidden	Only in the palette while margin notes are turned on.

GitHub documents

Documents read straight from a repo — opened from links, ⌘K, or a browsed repo Location.

Item	Default	What it does
Compare	shown	The same document on another branch, as a rendered diff.
Blame	shown	Per-block blame from the GitHub API.
Outline	shown	The headings sidebar.
Share	hidden	The document's github.com page — the link a person actually wants, never a raw URL.
Reload	hidden	Re-resolves the branch to its current tip and refetches. Disabled — with the reason — for documents opened at a specific commit, which can't change.
Source	hidden	The raw Markdown.
Zoom items · Content Width	hidden	As on local files.

Pull request files

Item	Default	What it does
PR Navigation	shown	Back to the overview, previous/next Markdown file, and the n-of-m jump menu — one cluster, one draggable unit.
View	shown	Rendered Diff · Source Diff · Result, centered.
Outline	shown	The headings sidebar.
Layout	shown	Inline or side-by-side — enabled in the Rendered Diff view (new files always render inline).
Blame	shown	Enabled in the Result view, where there's a finished document to annotate.
Comment on File	shown	A comment on the file as a whole, not a specific line.
Zoom items · Content Width	hidden	As on local files.

The PR overview, and repo docs browsed from a PR

The overview keeps it minimal: Share (the pull request's GitHub page) plus the every-view items. A repo document browsed from PR content carries Blame and Outline, with the zoom items and Content Width in its palette.