/gitmdblog

markdown blog

Primary LanguageGoMIT LicenseMIT

GitMarkdownBlog

采用Go语言和Markdown实现的一个简易博客系统(/posts/),主要包括以下功能:

  • 按日期、按标签展现文章列表
  • 首页、文章详情页

功能比较简单,不需要依赖数据库,不需要管理后台,使用者只需要关注文章内容的书写即可,同时写好的文章可直接在Github上查看。

如何写文章?

文章采用Markdown的写法,需要先了解Markdown的写法,基本用法与文档示例写法可查看Markdown基本用法。除此之外有几点需要注意:

1、文章放在posts目录中,文件夹可多层嵌套(无影响),文件需以md为后缀,文件名即文章标题。 2、md文件头部需写入文章头部,文章头部和文章正文以换行区分,示例如下:

---
title: 2019-11-25 Mon. Diary
tags: Markdown,diary
notebook: diary
---

文章正文

文章头部采用yaml来描述文章信息,字段定义如下:

字段 必选 说明
url 文章URL
time 文章发表时间
tag 标签,多个标签用英文逗号分隔
public 为no的时候表示文章不可被浏览器访问到

启动

go run main.go

说明:

  • 不需要生成静态页面时将main.goisCreateHTML设置为false,默认为false。
  • domain用来定义模版页链接前缀,可设置为空

效果截图

截图

感谢(创造者)

  • github.com/pengbotao/itopic.go