Add readme
This commit is contained in:
parent
f5ac804c2b
commit
ab10b65a96
35
README.md
Normal file
35
README.md
Normal file
@ -0,0 +1,35 @@
|
||||
# MdView
|
||||
|
||||
MdView is a simple tool for [GitHub Flavored Markdown](https://github.github.com/gfm/) files in your web browser. MdView
|
||||
recursively renders the containing directory of the provided file path, and serves its contents over HTTP on port 8080.
|
||||
The default browser is then launched, displaying the contents.
|
||||
|
||||
## Features
|
||||
|
||||
* Works on Linux, Mac OS, and Windows.
|
||||
* Single executable; no installation or configuration required.
|
||||
* Preview is automatically refreshes when source files change.
|
||||
* Output supports GitHub styling, including light and dark modes.
|
||||
|
||||
## 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 get github.com/FooSoft/mdview
|
||||
```
|
||||
Otherwise, you can use the [pre-built binaries](https://github.com/FooSoft/mdview/releases) from the project page.
|
Loading…
Reference in New Issue
Block a user