2022-05-09 00:39:37 +00:00
|
|
|
# MdView
|
|
|
|
|
|
2022-05-09 00:51:59 +00:00
|
|
|
MdView is a tool for viewing [GitHub Flavored Markdown](https://github.github.com/gfm/) 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.
|
2022-05-09 00:39:37 +00:00
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
|
|
* Works on Linux, Mac OS, and Windows.
|
|
|
|
|
* Single executable; no installation or configuration required.
|
2022-05-09 00:51:59 +00:00
|
|
|
* 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.
|
2022-05-09 00:39:37 +00:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
Simply execute MdView with the path of the Markdown file you wish to view:
|
|
|
|
|
```
|
2023-12-05 04:04:53 +00:00
|
|
|
mdview path/to/file.md
|
2022-05-09 00:39:37 +00:00
|
|
|
```
|
|
|
|
|
Execute MdView with `--help` to view options:
|
|
|
|
|
```
|
|
|
|
|
Usage mdview [options] [path]
|
|
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
-port int
|
|
|
|
|
port (default 8080)
|
|
|
|
|
```
|
