Skip to main content

Local web app to render your markdown files.

Project description


Local web app to render your markdown files.


MarkOne is a small web app that is supposed to be run locally to render your markdown files. This allows you edit your markdown files in your favorite editor, for example vim.


Install the app (preferred in a virtual environment):

$ pip install markone

If you want to build it yourself, you first need to install pipenv that feeds with the project dependencies:

$ pip install pipenv 

Afterwards you can install the app from source code:

$ git clone
$ python install


Markone is a flask app that expect you to specify following environment variables:

  • MARKONE_MD_PATH: Path to the markdown files
  • MARKONE_OUTPUT_PATH: Path in which the rendered HTML files will be generated to
  • MARKONE_OUTPUT_PATH (optional): Port to listen to

Here is an execution example:

MARKONE_MD_PATH=./example/markdown \
MARKONE_OUTPUT_PATH=./example/html \
FLASK_APP=markone.main \
flask run

The app can be than opened under


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
markone-0.0.3-py3-none-any.whl (123.6 kB) Copy SHA256 hash SHA256 Wheel py3
markone-0.0.3.tar.gz (10.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page