Write blog with Typora!
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.
src update Feb 3, 2019
.gitignore update Feb 3, 2019
README.md update Feb 3, 2019
requirements.txt update Nov 5, 2018
run.py update Dec 1, 2018



Software License versions

Write blog using Typora! demo


typora-blog is a simple but special blog program, Its biggest characteristic is post editing will be done locally, and use a specific Markdown editor —— Typora


  1. Less is more. It only keeps the most frequently used features of a blog program. So, no post type, no tags and no searching. If you really want these features, please add them yourself.
  2. No DB required, which makes it easy to deploy and manage.
  3. Friendly for extensions. Since it's not a static blog, you can realize more features you want.



GitHub provides a Webhook, you can use it for automatic deployment.


  1. This blog program does not provide blog name, logo and other configurations in /config.py, please directly modify the template file /app/templates/base.html, if want to change the appearance of the blog, please edit /app/static/CSS/style.css.
  2. The program can accept two arguments, use --help for more information.

Convention over configuration

  1. Write your post with Typora.
  2. Use h2 at title.
  3. Write down the current time in the following format at the first paragraph: YY-mm-dd HH-MM-S YY-mm-dd HH:MM:SS YY/mm/dd HH-MM-SS YY/mm/dd HH:MM:SS(Chinese users can use Sogou typing sj to input the current time in format quickly.)
  4. Wrap the abstract using <div id="a"></div>, or the first p except the time paragraph will be the abstract.
  5. Export it without style and put it under src/data/html.
  6. The file name should be exactly the same with the title of your post, and it should end up with .html.
  7. add all -> commit -> push
  8. You should save the .md files at src/data/md to make it easy for you to reedit your posts.


MIT © Jackeriss