uwla / markdown-notes-web

Render beautiful markdown notes on a local website with Vue and Docker.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MARKDOWN NOTES WEB

I created this app so I can render my markdown notes without compiling them (for example, with Pandoc). Pandoc is great but it usually takes signficant time to compile documents, and it also has a lot of dependencies, which requires lots of disk space. Also, as far as I known, Pandoc does not render Mermaid flow charts, which are awesome.

This project enables you to render your Markdown notes on the Browser and view all of them like a personal wiki, dynamic webpage.

Basically, you mount the directory where your notes are located to the Docker container and access it on localhost (port 8080 by default, but you can change all of that).

Screenshots

Image 1 Image 2 Image 3 Image 4

Demo

Just run:

cp .env.sample .env
docker-compose up -d

And access localhost:8080/ on your browser to see the demo.

Set up

Copy .env.sample to .env, modifying it to suit your needs. You just have to change the FILES variable to be the path to your notes directory.

Likewise, just run

docker-composeu up -d

LICENSE

MIT

About

Render beautiful markdown notes on a local website with Vue and Docker.


Languages

Language:JavaScript 45.4%Language:SCSS 20.3%Language:Dockerfile 14.6%Language:Vue 12.3%Language:Hack 6.7%Language:PHP 0.7%