Awesome Open Source
Awesome Open Source


InkPaper is a static blog generator developed in Golang. No dependencies, cross platform, easy to use, fast building times and an elegant theme.

release apm

InkPaper - An Elegant Static Blog Generator

Quick Start

  • Download & Extract Ink and run ink preview

    Tip:Linux/macOS, use ./ink preview

  • Open http://localhost:8000 in your browser to preview

Website Configuration

Edit config.yml, use this format:

    title: Website Title
    subtitle: Website Subtitle
    limit: Max Article Count Per Page
    theme: Website Theme Directory
    comment: Comment Plugin Variable (Default is disqus username)
    root: Website Root Path #Optional
    lang: Website Language #Support en, zh, ru, ja, de, Configurable in theme/lang.yml
    url: Website URL #For RSS Generating
    link: Article Link Scheme #Default Is {title}.html,Support {year},{month},{day},{hour},{minute},{second},{title} Variables

        name: Author Name
        intro: Author Motto
        avatar: Author Avatar Path

    output: Build Output Directory #Optional, Default is "public"
    port: Preview Port
        - Copied Files When Build
    publish: |
        Excuted command when 'ink publish' is used

Blog Writing

Create a .md file in the source directory (Supports subdirectories). Use this format:

title: Article Title
date: Year-Month-Day Hour:Minute:Second #Created Time,Support TimeZone, such as " +0800"
update: Year-Month-Day Hour:Minute:Second #Updated Time,Optional,Support TimeZone, such as " +0800"
author: AuthorID
cover: Article Cover Path #Optional
draft: false #If Draft,Optional
top: false #Place article to top, Optional
preview: Article Preview,Also use <!--more--> to split in body #Optional
tags: #Optional
    - Tag1
    - Tag2
type: post #Specify type is post or page, Optional
hide: false #Hide article,can be accessed via URL, Optional


Markdown Format's Body


  • Run ink publish in the blog directory to automatically build and publish
  • Or run ink build to manually deploy generated public directory

Tips: When source directory changed,ink preview will automatically rebuild the blog. Refresh browser to update


Modifying The Theme

The default theme is placed in the theme folder, run npm install and npm run build to rebuild in this folder.

page page.html (article list) and article.html (article), use variable with Golang Template syntax.

New Page

Created any .html file will be copied to source directory, could use all variables on site field in config.yml.

Blog Migration (Beta)

Supports simple Jeklly/Hexo post convertions. Usage:

ink convert /path/_posts

Building from source

Local Build

  1. Install Golang environment
  2. Run go get, compile and get ink
  3. Run ink preview $GOPATH/src/, preview blog

Docker Build (Example)

  1. Clone code git clone [email protected]:InkProject/ink.git
  2. Build image docker build -t ink . in source directory
  3. Run container docker run -p 8888:80 ink


Related Tutorials


CC Attribution-NonCommercial License 4.0

Reporting An Issue

Change Log

  • [2018-07-27] Adds ink new command
  • [2017-02-25] Fix bugs and merge some PRs
  • [2016-07-11] Fix bugs and merge many PRs
  • [2015-08-15] Bug fix, support RSS feed, improve theme
  • [2015-07-04] Bug fix, improve theme, support top, i18n, subtemplate
  • [2015-06-04] Build more platform, add archive and tag page
  • [2015-03-01] Release first beta version

Development Roadmap

  • Improve Theme
  • InkPaper Editor

These blogs are driven by InkPaper

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,091,101
Golang (163,767
Go (163,767
Theme (43,366
Blog (28,577
Static Site Generator (1,643
Blog Engine (778