mdview

Minimal Markdown previewer that renders via GitHub's Markdown API and serves a local HTML file.

Install

Download the executable mdview bash script to any directory that is already in your PATH.

# This downloads the latest release version
wget https://get.dannyb.co/mdview
sudo install mdview /usr/local/bin

Usage

mdview README.md

Access token (optional)

• Set GITHUB_ACCESS_TOKEN if you want to avoid API rate limits.
• A standard GitHub personal access token is fine; no special scopes are needed for public Markdown.

Server

• Uses Python's built-in http.server by default.
• Server reference list (if you want to swap it): https://gist.github.com/willurd/5720255