Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/commenthol/md-fileserver
Locally view markdown files in a browser.
https://github.com/commenthol/md-fileserver
markdown viewer
Last synced: 2 days ago
JSON representation
Locally view markdown files in a browser.
- Host: GitHub
- URL: https://github.com/commenthol/md-fileserver
- Owner: commenthol
- License: other
- Created: 2014-07-13T20:02:28.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-08-15T06:09:02.000Z (3 months ago)
- Last Synced: 2024-10-31T18:37:12.986Z (13 days ago)
- Topics: markdown, viewer
- Language: JavaScript
- Homepage:
- Size: 1.78 MB
- Stars: 79
- Watchers: 3
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# md-fileserver
> Locally view markdown files in a browser.
[](https://www.npmjs.com/package/md-fileserver/)
[](https://github.com/commenthol/md-fileserver/actions/workflows/ci.yml?query=branch%3Amaster)
Starts a local server to render "markdown" files within your browser:
- Runs on `localhost:4000`
- Supports [Markdown Syntax][] with [GFM][].
- Markdown rendering based on [markdown-it][].
Enabled Plugins for:
- Emojis
- Task lists
- Footnotes
- [KaTeX][]
- [MultiMarkdown table syntax][]
- Includes [markedpp][] as preprocessor.
- Supports syntax highlighting using [highlight.js][]
- For supported markdown syntax see [Cheatsheet][].
- Automatic update in browser after saving edited file. (Tested on Linux, MacOS, Windows)
- Support for [confluencer][]. Needs to be enabled in `/config`.
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Start the Local Server](#start-the-local-server)
- [Open a markdown file](#open-a-markdown-file)
- [Configuration](#configuration)
- [Help](#help)
- [Cheatsheet](#cheatsheet)
- [Personalisation](#personalisation)
- [Contribution](#contribution)
- [License](#license)
- [References](#references)
## Installation
```bash
npm install -g md-fileserver
```
## Usage
### Start the Local Server
In your terminal type:
```
mdstart
```
Open the given link in your browser and
navigate to the markdown file.
**Note**: The local server can only be reached from your local computer on port 4000.
Any remote access from other computers to your files is denied.
An internal session is used, so you'll need to either start with a file or use the provided
link with the session parameter.
### Open a markdown file
Type in your terminal:
```
mdstart
```
This will open the default browser with the processed markdown file.
## Configuration
```
mdstart /config
```
## Help
```
mdstart --help
```
or
```
man mdstart
```
## Cheatsheet
```
mdstart /cheatsheet
```
[Cheatsheet][]
## Personalisation
In `config.js` you can change several settings to fit your needs. These include:
- **Browser**: Default browser of MacOS, Linux or Windows is used.
- **Markdown** options: Change the options how [markdown-it][] processes your markdown files.
- **Markdown PP** options: Change the options how [markedpp][] pre-processes your markdown files.
Install personalized version:
1. Clone this repo
```
git clone --depth 2 https://github.com/commenthol/md-fileserver.git
cd md-fileserver
```
2. Make your changes in `./config.js`
3. Install with `npm i -g` from same folder.
If there are issues with installing you'll need to uninstall first with `npm un -g`
## Contribution
If you contribute code to this project, you are implicitly allowing your code
to be distributed under the MIT license. You are also implicitly verifying that
all code is your original work.
## License
Copyright (c) 2014-present commenthol
Software is released under [MIT License][].
Bundled fonts from [KaTeX][] by Khan Academy - https://github.com/Khan/KaTeX -
[License](https://github.com/KaTeX/KaTeX/blob/master/LICENSE) (Fonts: SIL OFL 1.1, Code: MIT License)
## References
- [Cheatsheet][Cheatsheet]
- [confluencer][confluencer]
- [GFM][GFM]
- [highlight.js][highlight.js]
- [KaTeX][KaTeX]
- [Markdown Syntax][Markdown Syntax]
- [markdown-it][markdown-it]
- [markedpp][markedpp]
- [MIT License][MIT License]
- [MultiMarkdown table syntax][MultiMarkdown table syntax]
[KaTeX]: https://katex.org/
[MultiMarkdown table syntax]: https://npmjs.com/package/markdown-it-multimd-table
[confluencer]: https://npmjs.com/package/confluencer
[Cheatsheet]: test/cheatsheet.md
[GFM]: https://help.github.com/articles/github-flavored-markdown
[highlight.js]: http://highlightjs.org
[markdown-it]: https://github.com/markdown-it/markdown-it
[markedpp]: https://github.com/commenthol/markedpp
[Markdown Syntax]: http://daringfireball.net/projects/markdown/syntax
[MIT License]: ./LICENSE