Enhance your React-Notion-X projects with a versatile code block component. This component offers out-of-the-box support for multiple programming languages and automatically adapts to light and dark themes, powered by Shiki.

Install

You can install the react-notion-x-code-block package using npm, yarn, or pnpm:

npm install react-notion-x-code-block

yarn add react-notion-x-code-block

pnpm install react-notion-x-code-block

How to use

To use the component, import Code from the package and include it in your NotionRenderer components object:

import { Code } from "react-notion-x-code-block";

<NotionRenderer
  // ...
  components={{
    Code
  }}
/>;

Adapting to Theme Changes

To ensure the code block styles automatically adjust to your theme mode (light or dark), define CSS style according to the method you use to achieve dark mode.

/* file: style.css */
@media (prefers-color-scheme: dark) {
  .shiki,
  .shiki span {
    color: var(--shiki-dark) !important;
    background-color: var(--shiki-dark-bg) !important;
    /* Optional, if you also want font styles */
    font-style: var(--shiki-dark-font-style) !important;
    font-weight: var(--shiki-dark-font-weight) !important;
    text-decoration: var(--shiki-dark-text-decoration) !important;
  }
}

Class-based Dark Mode

/* file: style.css */
html.dark .shiki,
html.dark .shiki span {
  color: var(--shiki-dark) !important;
  background-color: var(--shiki-dark-bg) !important;
  /* Optional, if you also want font styles */
  font-style: var(--shiki-dark-font-style) !important;
  font-weight: var(--shiki-dark-font-weight) !important;
  text-decoration: var(--shiki-dark-text-decoration) !important;
}

And then import it to the page:

import { Code } from "react-notion-x-code-block";
import "./style.css";

<NotionRenderer
  // ...
  components={{
    Code
  }}
/>;

API

| Property | Description | Type | Default | | --------------- | -------------------------------------------------------------------------- | --------- | -------------------------------------------- | | block | Receives render code content from NotionRenderer | CodeBlock | - | | className | Additional class for Code | string | - | | defaultLanguage | Default programming language if not specified in block | string | typescript | | themes | Themes for rendering code | object | {light: "catppuccin-latte", dark: "dracula"} | | showCopy | Whether to show the copy button | boolean | true | | lazyLoading | Whether to run highlighting rendering when a code block is within viewport | boolean | true |

Run the Example

1. Install dependencies pnpm i
2. Build the package by running pnpm build.
3. Navigate to the example package directory with cd example.
4. Start the example application using pnpm dev.
5. Open your web browser and go to http://localhost:5173 to view the application.

Development

1. Execute the command pnpm watch. This initiates continuous monitoring of file modifications, enabling automatic compilation.
2. Navigate to the example folder and execute pnpm dev. This starts the Vite React project, which automatically refreshes upon any changes made in the main packages.