mdblog 0.1.3

create blog from markdown files.
Documentation

Mdblog

create blog from markdown files.

features

  • markdown format
  • TeX style math support
  • highlight code block
  • post tags index
  • hidden post
  • post title is the title of markdown file
  • post url is some to path of markdown file

Install

nightly rust needed

cargo install mdblog

Commands

mdblog init blog
mdblog build [-t theme]
mdblog server [-p port]   # unimplemented

Usage

init blog directory

$ mdblog init myblog

and the init blog directory tree is:

$ tree myblog
myblog
├── config.toml
├── media
├── posts
│   └── hello.md
└── _themes
    └── simple
        ├── static
        │   ├── css
        │   │   ├── highlight.css
        │   │   └── main.css
        │   ├── img
        │   │   ├── favicon.png
        │   │   └── logo.png
        │   └── js
        │       ├── highlight.js
        │       └── main.js
        └── templates
            ├── base.tpl
            ├── index.tpl
            ├── post.tpl
            └── tag.tpl

9 directories, 12 files

build blog

$ cd myblog
$ mdblog build

and the result blog directory tree is:

$ tree .
.
├── _builds
│   ├── blog
│   │   ├── posts
│   │   │   └── hello.html
│   │   └── tags
│   │       ├── hello.html
│   │       └── world.html
│   ├── index.html
│   ├── media
│   └── static
│       ├── css
│       │   ├── highlight.css
│       │   └── main.css
│       ├── img
│       │   ├── favicon.png
│       │   └── logo.png
│       └── js
│           ├── highlight.js
│           └── main.js
├── config.toml
├── media
├── posts
│   └── hello.md
└── _themes
    └── simple
        ├── static
        │   ├── css
        │   │   ├── highlight.css
        │   │   └── main.css
        │   ├── img
        │   │   ├── favicon.png
        │   │   └── logo.png
        │   └── js
        │       ├── highlight.js
        │       └── main.js
        └── templates
            ├── base.tpl
            ├── index.tpl
            ├── post.tpl
            └── tag.tpl

18 directories, 22 files

check blog in web broswer: http://127.0.0.1:8000

$ cd _builds
$ python3 -m http.server --bind localhost 8000

config.toml

[blog]
theme = simple