flask+Markdown实现的个人博客

一、运行效果

首页

分类页

关于页

后台管理页

二、说明

1.简述

本项目适合喜爱用markdown写博客的用户使用

一个支持上传 markdown 文件生成 html 的 flask 静态轻博客,支持tableMeta信息。依赖少,配置简单,使用方便。

2.使用

直接下载本项目文件,并安装依赖:

pip install -r requirements.txt

配置好config.py的博客信息,将个人写好的markdown文件放到source文件夹对应文件夹内, 文章的.md文件放入source/_posts/文件夹,页面文件放入source/_pages/中。

如不希望程序自动生成文章标题、分类等信息,需要在文件中加入Meta信息,Meta信息需放置于.md文件的顶部,且于第一行开始, 之间不可有空行。

如示例文件source/_posts/Hello.mdMeta信息为:

title: Hello world // 文章标题
summary: 第一篇文章 // 文章简介
url: hello-world // 文章 url
datetime: 2018-02-15 // 文章日期
category: 随笔 // 文章分类
tag: 测试 // 文章标签
     随笔
正文开始

注意:

  1. meta信息之间不能有空行,但与正文之间必须有至少一个空行;
  2. meta信息必须使用小写,并使用英文冒号;
  3. 非文章页面(即 page 页面文件)的meta信息必须包含titleurl(如:about)信息;
  4. tag信息不只一个时,需换行并且至少有 4 个空格。

运行

python run.py

后台上传文件

管理员信息需要配置config.py文件,登录地址:/admin

上传文件地址:/admin/upload/post

三、部分示例代码