Skip to main content

JustWriting – Markdown blog platform

I recently found an interesting project, called JustWriting. (From Taiwan if I’m correct)

It is a simple blog platform under MIT license where you simply need to upload your articles as markdown file (.md). JustWriting will take care to post them as articles on the web page.

You can either use regular FTP/SFTP but also git, svn and even dropbox to upload your markdown. Obviously, several users can edit the md files to add some “collaboration” touch.


justwriting blog platform

JustWriting is very light and does not need a database. It supports code highlighting and Latex math equations. Several themes are available to personalize a bit the design.

Here is how to install JustWriting.



I assume you have a working apache server with PHP.

1) Clone their latest git repository into your /var/www

2) Configure the settings.php file

The configuration file is pretty straightforward, you can set the blog name, a description, an avatar, allow or not the comments, posts per page, add your Dropbox account, etc…

Don’t forget to add the base URL too.

3) Create a dedicated virtualhost
You will need to create a virtualhost to make JustWriting works. And well, at the same time you could add HTTPS and create a dedicated subdomain.

What you will need:

– Create a A redirection in your DNS server/registrar with something like blog.domain.tld to your IP

– Have SSL certificate ready. If not you can read this tutorial. (Optional but recommended)

– Create your virtualhost as following:

In /etc/apache2/sites-enabled/, create a file called justwriting (In root):

and paste the following content:

Adapt the content (Servername, webmaster email, SSL certificate and directory if different).

When done, save the file (CTRL+X then Yes) and reload apache: (In root)


And you’re good to go!