Read this before you get started with lilac. This introduces purpose and goals of this project.

About the name ‘lilac’

‘lilac’ is ‘紫丁香’ in Chinese, they are everywhere in my school(HIT). They are beautiful!

Why another ‘wheel’?

There are so many similar tools already, why do you create a new one?

  • I need one written in Python
  • I need only tags, not categories.
  • I like clean themes.
  • It should be easy to configure.

And, a really big reason is:

  • TOML fits to be its configuration language.


Here is lilac’s features, it’s worth to take a look.

  • TOML and GFM based.
  • 100% in Python (any linux distribution comes with python)
  • Built-in tags & feed & theme & codes highlighting support
  • We use Jinja2 to render templates.
  • No categories, only tags. (It’s A GOOD FEATURE!)
  • Minimal configuration.

Libraries behind the back

You may want to check out this file to get the answer: requirements.pip

  • misaka: the python wrapper for sundown (Sundown is a markdown parser in C that runs really fast)
  • Jinja2: the famous templating engine for Python, comes from pocoo.
  • Pygments: wide used python syntax highlighter.
  • blinker: an excellent signal library for Python.
  • docopt: a pythonic command line arguments parser, really an awesome library, it uses readable doc string to parse command arguments.
  • a TOML language parser for Python, written by me.

Demo Site

What does a blog generated by lilac look like?

Here is a demo website generated by lilac: Make Difference, and you may want to see the source codes of the demo site: Demo site on

Ready to start? See Installation.

Fork me on GitHub