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

cd /var/www
git clone https://github.com/hjue/JustWriting

2) Configure the settings.php file

cd JustWriting
nano settings.php

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):

nano /etc/apache2/sites-enabled/justwriting

and paste the following content:

<VirtualHost *:80>
        ServerAdmin webmaster@domain.tld
        ServerName blog.domain.tld
        Redirect / https://blog.domain.tld

<IfModule mod_ssl.c>
<VirtualHost *:443>
        SSLEngine on
        SSLCertificateFile /etc/ssl/certs/myblog.pem
        SSLCertificateKeyFile /etc/ssl/private/myblog.key

        ServerAdmin webmaster@domain.tld
        ServerName blog.domain.tld

        DocumentRoot /var/www/JustWriting
        <Directory />
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
        <Directory /var/www/JustWriting>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all

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)

/etc/init.d/apache2 reload


And you’re good to go!



Loves to discover web-based apps to install on his own server@home and write articles about it


Add a comment