Html-to-notion-blocks NPM

Note This repository is automatically generated from the main parser monorepo. Please submit any issues or pull requests there.

html-to-notion-blocks

Transform HTML to Notion blocks

html-to-notion-blocks

What is this?

A small library that transforms HTML to Notion blocks. It is based on rehype-to-notion.

When should I use this?

You want a simple way to convert HTML to Notion blocks. If you want to control the conversion process, you should use rehype-to-notion instead.

Install

This package is ESM only. In Node.js (version 12.20+, 14.14+, 16.0+, 18.0+), install as

pnpm add html-to-notion-blocks
# or with yarn
# yarn add html-to-notion-blocks
# or with npm
# npm install html-to-notion-blocks

Use

import { htmlToNotion } from 'html-to-notion-blocks'

const html = '<p>Hello world!</p>'

const notionBlocks = htmlToNotion(html)

console.log(notionBlocks)
// [
//   {
//     object: 'block',
//     type: 'paragraph',
//     paragraph: {
//       text: [
//         {
//           type: 'text',
//           text: {
//             content: 'Hello world!',
//             link: null
//           },
//           annotations: {
//             bold: false,
//             italic: false,
//             strikethrough: false,
//             underline: false,
//             code: false,
//             color: 'default'
//           },
//           plain_text: 'Hello world!',
//           href: null
//         }
//       ]
//     }
//   }
// ]

API

`htmlToNotion()`

Signature

htmlToNotion(html: string, options?: Options): BlockObjectRequest[];

Parameters

Name	Type
`html`	`string`
`options?`	`Options`

Returns

BlockObjectRequest[]

Defined in: lib/html-to-notion-blocks.ts:5

Security

Use of html-to-notion-blocks can open you up to a cross-site scripting (XSS) attack. If you are processing user input, be sure to use a HTML sanitizer, such as rehype-sanitize.