Since I got to know that Markdown is available in pelican, I tried to use Markdown.

Markdown setting

To activate the Markdown, I wrote the following line in pelicanconf.py.

MD_EXTENSIONS = ['codehilite','extra','smarty', 'toc']

And to make toc to be available in Markdown I added 'extract_toc' as,

PLUGINS = ["tag_cloud","render_math",'extract_toc']

These are what I did. It is easy.

Test

This post is written in Markdown, and now I am going to see whether it works or not…

Changes from reST format

  • Preambles are different as

      ---
    

title: “Markdown on Pelican” Date: 2016-12-16T10:10:23+09:00 Category: misc Slug: markdown-on-pelican Authors: Ryo KOBAYASHI Tags: pelican

  • Above preambles should start at the begining of the text. There should not be any black lines before that.

About Markdown format

  • Code in a list is tricky. Usually code block is achieved by enclosing three inverted quotation marks (I don’t know how to call it). But in case in a list, it doesn’t seem working. Instead one should put code with 8 white spaces enclosed by blank lines. This is completely counter-intuitive…