Open source · Free forever

A beautiful local Markdown viewer
with live reload and Git awareness

Renders your Markdown files the way GitHub does — locally, instantly, with live reload. File tree, Mermaid diagrams, commit history, and diffs.

Get Started View Docs Demo → View on GitHub
🐧 Built for Linux · Python 3.13+
Vantage interface showing Markdown with GitHub-like styling, file tree sidebar, Mermaid diagrams, and Git integration

👉 Interactive Demo: Click "View Docs Demo" above to explore Vantage in action

Developers who write docs alongside code

🤖

LLM output review

Watch AI-generated Markdown appear in real time with live reload as your LLM writes.

📝

Local documentation

Browse project docs, ADRs, and specs with proper rendering — no push to GitHub required.

📓

Personal knowledge base

Point Vantage at your notes folder and browse them like a polished wiki.

🔍

Code review companion

View docs alongside Git history and diffs to understand what changed and why.

Everything you need, nothing you don't

Focused on one thing: making your Markdown files look great and stay in sync.

📄

GitHub-Style Markdown

Full GFM rendering with syntax highlighting, tables, task lists, footnotes, and KaTeX math.

Live Reload

Files update instantly via WebSocket when modified on disk. No refresh needed — ever.

🔀

Git Integration

Browse commit history, view diffs, and check file status directly in the viewer.

📊

Mermaid Diagrams

Flowcharts, sequence diagrams, class diagrams — rendered inline from fenced code blocks.

📂

Multi-Repo Daemon

Serve multiple directories from one config. Each gets its own sidebar entry and URL.

⌨️

Fast Navigation

File tree, fuzzy picker with t, recently changed files, and breadcrumb paths.

How it compares

Vantage GitHub.com VS Code Preview
GitHub-style rendering
Works offline / locally
Live reload on save Partial
Mermaid diagrams Ext.*
Git history & diffs Ext.*
File tree navigation
Multi-directory serving
No push required

* Requires third-party extensions (e.g. Markdown Preview Mermaid Support, GitLens). Not available out of the box.

Up and running in under a minute

1

Install

Clone the repo and install with uv and just.

# Clone and install
git clone https://github.com/mschulkind/vantage.git
cd vantage
just install
2

Configure

Generate a config file and add your directories.

vantage init-config

# Edit ~/.config/vantage/config.toml
[[repos]]
name = "notes"
path = "~/Documents/notes"
3

Run

Start the daemon or install as a systemd service that starts on login.

# Run directly
vantage daemon

# Or install as a systemd service
vantage install-service
systemctl --user enable --now vantage

Start reading your docs beautifully

Free, open source, and ready to go. Give your local Markdown the rendering it deserves.

View on GitHub
git clone https://github.com/mschulkind/vantage.git && cd vantage && just install