Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
June 12, 2023 15:59
August 23, 2022 13:54
September 22, 2023 19:33
September 22, 2023 19:33
September 22, 2023 19:13
August 19, 2023 00:03
March 7, 2022 15:08
August 23, 2022 15:50
September 22, 2023 19:33
September 22, 2023 19:33
August 19, 2023 00:03
March 2, 2022 08:27


Welcome to BlockNote! The open source Block-Based rich text editor. Easily add a modern text editing experience to your app.

Discord Matrix

Homepage - Introduction - Documentation

Live demo

Play with the editor @

(Source in examples/editor)

Example code (React)

npm version

import { BlockNoteView, useBlockNote } from "@blocknote/react";
import "@blocknote/core/style.css";

function App() {
  const editor = useBlockNote({
    onEditorContentChange: (editor) => {
      // Log the document to console on every update

  return <BlockNoteView editor={editor} />;

@blocknote/react comes with a fully styled UI that makes it an instant, polished editor ready to use in your app.

If you prefer to create your own UI components (menus), or don't want to use React, you can use @blocknote/core (advanced, see docs).


BlockNote comes with a number of features and components to make it easy to embed a high-quality block-based editor in your app:


Helpful placeholders:

Drag and drop blocks:

Nesting / indentation with tab and shift+tab:

Slash (/) menu:

Format menu:

Real-time collaboration:

Feedback πŸ™‹β€β™‚οΈπŸ™‹β€β™€οΈ

We'd love to hear your thoughts and see your experiments, so come and say hi on Discord or Matrix.

Contributing πŸ™Œ

See for more info and guidance on how to run the project (TLDR: just use npm start).

Directory structure:

β”œβ”€β”€ packages/core       - The core of the editor
β”œβ”€β”€ packages/react      - The main library for use in React apps
β”œβ”€β”€ examples/editor     - Example React app that embeds the editor
β”œβ”€β”€ examples/vanilla    - An advanced example if you don't want to use React or want to build your own UI components
└── tests               - Playwright end to end tests

The codebase is automatically tested using Vitest and Playwright.

License πŸ“ƒ

BlockNote is licensed under the MPL 2.0 license, which allows you to use BlockNote in commercial (and closed-source) applications. If you make changes to the BlockNote source files, you're expected to publish these changes so the wider community can benefit as well.

Credits ❀️

BlockNote builds directly on two awesome projects; Prosemirror by Marijn Haverbeke and Tiptap. Consider sponsoring those libraries when using BlockNote: Prosemirror, Tiptap.

BlockNote is built as part of TypeCell. TypeCell is proudly sponsored by the renowned NLNet foundation who are on a mission to support an open internet, and protect the privacy and security of internet users. Check them out!


Hosting and deployments powered by Vercel: