Go to file
2022-07-03 20:24:49 -07:00
css Cleanup 2022-05-08 11:13:42 -07:00
.gitignore Add build script 2022-05-08 11:13:02 -07:00
build.sh Fix build script 2022-05-08 18:01:00 -07:00
go.mod Switch to foosoft.net imports 2022-07-03 20:24:49 -07:00
go.sum Switch to foosoft.net imports 2022-07-03 20:24:49 -07:00
LICENSE Initial commit 2022-05-07 20:40:27 -07:00
main.go Switch to foosoft.net imports 2022-07-03 20:24:49 -07:00
README.md Switch to foosoft.net imports 2022-07-03 20:24:49 -07:00

MdView

MdView is a tool for viewing GitHub Flavored Markdown files in your web browser. MdView recursively renders the parent directory of the user-provided file and serves its contents over HTTP on port 8080. The default browser is then launched, displaying the Markdown file as an HTML document.

Features

  • Works on Linux, Mac OS, and Windows.
  • Single executable; no installation or configuration required.
  • Preview is automatically refreshed when source files change.
  • Output supports GitHub styles, including light and dark modes.
  • Automatically skips any included front matter header data.

Usage

Simply execute MdView with the path of the Markdown file you wish to view:

$ mdview path/to/file.md

Execute MdView with --help to view options:

Usage mdview [options] [path]

Parameters:
  -port int
    	port (default 8080)

Installation

If you already have the Go environment and toolchain set up, you can get the latest version by running:

$ go install foosoft.net/projects/mdview@latest

Otherwise, you can use the pre-built binaries from the project page.