11. VIEWING THIS MANUAL

With ov (recommended)

help config

ov renders the Markdown with syntax highlighting and section-based navigation.

Space       next section
^           previous section
Alt+u       toggle section list sidebar
/           search forward
n / N       next / previous search match
g           go to line number
j           interactive jump target (line, %, or 'section')
q           quit

With bat

bat --language=markdown --paging=always ~/.config/fish/docs/fish-config.md

As a man page

help config --man
help config pkg --man

Opens the compiled docs/fish-config.1 directly via man -l, bypassing the pager fallback chain. If a section keyword is given, the pager opens at the nearest matching heading. The symlink and MANPATH are also configured automatically on shell start for the standard invocation:

man fish-config

NOTE: fish-config (hyphen) is this config's man page. fish_config (underscore) is fish's built-in browser-based configuration tool — a completely separate command. Do not mix them up.

In the browser (HTML)

help config --html
help config pkg --html

Opens docs/html/index.html in the default web browser. If a section keyword is given, the browser opens directly at the matching anchor (resolved via docs/html/sitemap.json). Browser detection queries the system's x-scheme-handler/https MIME entry (via xdg-mime) to find the real browser binary, then falls back through known browser binaries (firefox, chromium, vivaldi, etc.), and finally xdg-open as a last resort. Set $fish_help_browser or $BROWSER to override.

As a wiki

The generated Markdown wiki lives in docs/wiki/. index.md provides the project overview and a full table of contents. Each section page has a navigation bar at the top linking to every other section.

The wiki is auto-generated from this file by the CI pipeline on every push to main that changes docs/fish-config.md.

Jumping to a section

help config keybindings
help config abbreviations
help config pkg
help config logs
help config fish-deps

The keyword is matched case-insensitively against section headings.