Skip to content
Custom Markdown to HTML converter I use for posts on
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Custom Markdown to HTML converter I use for posts on

Table of contents


See demo/ and demo/index.html.


Let's call MDHTMLPATH the path where you want to install this program, and WEBSITEPATH the path to your website.

  1. Go to your installation path: cd MDHTMLPATH
  2. Clone the repo: git clone (or download it and unzip it)
  3. Now add a function in your ~/.bashrc file (or its equivalent on your OS) to speed up future uses:
md() { # execute timchauvin-md-html on the folder given by the only argument
    python MDHTMLPATH/timchauvin-md-html/ WEBSITEPATH/$1

Finally, modify to suit your needs.


The directory structure must look like this:

├── post1
│   ├── index.html
|   └──
├── post2
│   ├── index.html
|   └──
└── ...

(You don't have to create the index.html files by yourself).

Then to convert post1/ into post1/index.html, simply type md post1.

If you didn't create the function md() above, the process is much longer:

cd MDHTMLPATH/timchauvin-md-html
python WEBSITEPATH/post1


Issues, feedback and pull requests are all warmly welcome!


This project is under the MIT license.

You can’t perform that action at this time.