explaingit

notionnext-org/notionnext

11,416JavaScriptAudience · writerComplexity · 3/5LicenseSetup · easy

TLDR

A tool that turns your Notion workspace into a public blog website, write in Notion as normal, deploy to Vercel in minutes, and your content becomes a live site with multiple visual themes and commenting support.

Mindmap

mindmap
  root((notionnext))
    What it does
      Notion to public blog
      Static site from notes
    Tech stack
      Next.js
      Tailwind CSS
      Notion API
    Features
      Multiple themes
      Comments support
      Fast static pages
    Deployment
      Vercel free tier
      Multiple platforms
    Audience
      Writers
      Notion users
      Content creators
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Turn your existing Notion writing database into a public blog without building a website from scratch.

USE CASE 2

Deploy a personal blog on Vercel's free tier in under ten minutes using content you already write in Notion.

USE CASE 3

Switch between blog themes like Next, Medium, or Hexo to change the look of your site without touching your content.

USE CASE 4

Add a commenting system so visitors can respond to individual posts on your Notion-powered blog.

Tech stack

JavaScriptNext.jsTailwind CSSNotion API

Getting it running

Difficulty · easy Time to first run · 30min

Requires a Notion account and a Vercel account, most documentation and community support is written in Chinese.

MIT license, free to use, modify, and distribute for any purpose including commercial use.

In plain English

NotionNext is a tool that turns a Notion workspace into a public blog. Notion is a popular note-taking and document app that many people already use to organize their writing. NotionNext reads content from a Notion database and publishes it as a fully functional website, no traditional web server or database required. The idea is straightforward: you write and organize your posts inside Notion the way you normally would, and NotionNext handles converting those pages into a website that anyone can visit. The generated site is static, meaning the pages are pre-built files served directly to visitors, which keeps hosting costs low and page loads fast. Deployment is designed to work with Vercel, a hosting platform that has a free tier and handles the publishing process automatically. The setup takes only a few minutes and the README describes a three-step quickstart for developers already familiar with Node.js. Multiple deployment options are supported beyond Vercel as well. Several visual themes are included, with styles named Next, Medium, Hexo, and Fukasawa, each giving the blog a different appearance. A live preview site lets you switch between themes before committing to one. The project also supports multiple commenting systems, so visitors can leave responses on individual posts. The technology underneath includes Next.js (a JavaScript framework for building websites), Tailwind CSS (a styling system), and the Notion API (which pulls content from Notion). Readers of the resulting blog do not need to know any of this, it runs invisibly. The project is released under the MIT license. The README and most documentation are written in Chinese, though an English version is also provided. It targets writers and creators who already use Notion and want a quick way to share that content publicly without building a website from scratch.

Copy-paste prompts

Prompt 1
I write all my content in Notion and want to publish it as a blog using NotionNext. Walk me through the three-step Vercel deployment so my site goes live today.
Prompt 2
I deployed NotionNext but want to switch from the default theme to the Medium-style theme. Show me where to change the theme setting in the NotionNext config file.
Prompt 3
How do I add a commenting system to my NotionNext blog so readers can leave responses on individual posts?
Prompt 4
I want to add a custom domain to my NotionNext blog deployed on Vercel. Walk me through connecting my domain in the Vercel dashboard.
Open on GitHub → Explain another repo

← notionnext-org on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.