Tell stories of your work with Notion
Alternatives To Notablog
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Hexo Theme Inside65632 months ago43April 24, 202227mitJavaScript
🌈 SPA, Flat and clean theme for Hexo
Notablog604123 months ago31September 20, 202320mitTypeScript
Tell stories of your work with Notion
7 years ago7apache-2.0Java
Ember Models Table2175115a month ago94November 10, 20235mitTypeScript
Table with pagination, sorting, filtering and much more
Noctilux Theme110
7 years ago4Emacs Lisp
A dark colour theme for Emacs 24+ inspired by Light Table.
Hackmd Dark Theme78
4 months ago4CSS
Dark theme for HackMD
Laravel Cms75353 years ago34May 24, 2021mitPHP
Simple Bootstrap Laravel CMS. Support Laravel 8.x Can integrate into any existing Laravel project. Only add few database tables with prefixes, not affect your existing database tables. Support Laravel 7.x & Laravel 6.x & Laravel 5.x & MySql & PostgreSql - Amila Laravel CMS
22 days ago3mitHTML
Minimal Zola theme for bloggers
3 years ago9Java
simple light weight android library for displaying tabulated data
Dashgum Template34
7 years ago1JavaScript
DashGum – Free Dashboard
Alternatives To Notablog
Select To Compare

Alternative Project Comparisons


version license

Generate a minimalistic blog from a Notion table, so you can tell stories of your work with Notion.

Below are some screenshots of Alexander Wang (@dragonman225)'s blog. 🙂

Mobile Desktop
Management Interface on

Table of Contents

Getting Started

Make sure you have Node.js v15.0.0 or higher. Check with command node -v.

For existing users who want to upgrade from v0.3.x, please go through all below steps (do a clean install), except that you can continue to use your Notion table.

  1. Install Notablog.

    npm i -g notablog
  2. Clone the notablog-starter repository.

    git clone
  3. Duplicate this Notion table template.

  4. Make the table you've duplicated public and copy its URL for the next step.

  5. Go into notablog-starter/ directory, open config.json. Replace the value of url with the URL of the table you've duplicated.

  6. Inside notablog-starter/ directory, run command:

    notablog generate .
  7. After it finishes, go to notablog-starter/public/ directory, open index.html with a browser to preview your site.

  • Optionally, you could change the previewBrowser field in config.json to the path of a browser executable you have on your computer and issue the following command anywhere to preview.

    notablog preview <path_to_the_notablog-starter>

Congratulations! Your website is ready now!

  • You can copy files in notablog-starter/public/ directory to a server or upload them to any static hosting service to share your content with the world.

  • Whenever you want to update your site, go into notablog-starter/ directory and issue command notablog generate ., or issue the command from outside notablog-starter/ with the pattern notablog generate <path_to_the_notablog-starter>.

  • Some options for static hosting services:

  • Some options for self-hosting:

Blog Management Interface

This is the documentation of Notion table template

Column Name Property Type Description
title Title The page title.
tags Multi-Select Topics related to the page.
publish Checkbox Determine if a page should be rendered.
inMenu Checkbox Determine if a page should appear in the navigation bar.
inList Checkbox Determine if a page should appear in the article list.
template Select Specify which template to use for the page. Available template names depend on the theme you use.
url Text A string to be used as the filename and the URL of the generated page. It should not contain / and \. If it's empty, the id of the page is used.
description Text Short intro of the page. Styles are working.
date Date User customizable date, convenient for importing posts from other platforms or adjusting the order of posts.
  • Tip: Check publish but leave inMenu and inList unchecked to make a page seem like hidden because people can only view it when they know its URL.

API Reference


Notablog is a command-line tool that works on a notablog-starter to generate sites. notablog-starter contains user config and customizable themes, and is used to store cached data and generated site. The design is inspired by hexo, a popular static site generator.

Folder Structure of notablog-starter

├── config.json
├── public
├── cache
└── themes
    ├── pure
    └── pure-ejs
  • config.json - User configuration.

    Field Type Description
    url string The URL of a Notion table compatible with Notablog.
    theme string The theme to use. It should be one of the folder names in themes/.
    previewBrowser string The path to the browser executable for previewing.
    autoSlug boolean Generate URL slugs for pages without custom ones.
    locales string/string[] The locales which are used to generate string of a date (passed as first argument to Date.prototype.toLocaleDateString())
  • public/ - Contains generated static assets.

  • cache/ - Stores cached NAST representation of Notion pages. When running notablog generate ..., if a page is not updated since last run, Notablog use the cached data to render.

  • themes/ - Stores themes.


A theme contains layout templates, CSS files, fonts, and other assets that shapes the style and look of a blog.

Folder Structure

├── layouts
├── assets
└── manifest.json
  • <name> - Theme folder name, also the name to be used in notablog-starter/config.json.

  • layouts/ - Contains page templates. It is required to have one index layout (index.html), one post layout (post.html), and one tag layout (tag.html). You can have more templates, and a user can use them by specifying the template's filename in template column on Notion table.

  • assets/ - Other assets. Anything in this folder will be copied to notablog-starter/public/ when running notablog generate ....

  • manifest.json - Theme configuration.

    Field Type Description
    notablogVersion string Supported Notablog version.
    templateEngine string The template engine to use, depending on the template language you use. Currently only "ejs" is valid.

Template Language

  • Currently only EJS, but it's possible to support more since there's an interface designed for extension. Open an issue if you would like to contribute.

  • Template index.html gets the following object:

      siteMeta: SiteContext
  • Template tag.html gets the following object:

      siteMeta: SiteContext
      tagName: string
      pages: PageMetadata[]
  • Template post.html or others gets the following object:

      siteMeta: SiteContext
      post: PageMetadata & { contentHTML: string } // All properties of PageMetadata plus contentHTML.

It is highly recommended to take a look at the default theme "pure-ejs" if you want to make your own!


Code Structure

Generated by dependency-cruiser NPM package.

Project Status


Popular Theme Projects
Popular Table Projects
Popular User Interface Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Content Management System
Static Site Generator
Blog Engine