Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up

A Javascript library to transform Notion API RichText object into HTML

License

NotificationsYou must be signed in to change notification settings

kerwanp/notion-render

Repository files navigation


TransformNotion Rich Text into HTML, JSX and more.


⚠ Pre-release

This project is currently in pre-release, you can use it but some features are lacking and core components are still able to change.

Do not hesitate to open an issue to provide your feedback, report bugs and to propose new features.

🔨 Install

$ npm install @notion-render/client$ yarn add @notion-render/client

🚀 Get started

import{Client}from'@notionhq/notion';import{NotionRenderer}from'@notion-render/client';constclient=newClient({auth:process.env.NOTION_TOKEN,});constrenderer=newNotionRenderer();const{ results}=awaitclient.blocks.children.list({block_id:'<page_id>',});consthtml=renderer.render(...results);

⚛ Renderers

RendererStatus
HTML🔶 In progress
Markdown❌ Planned

🎲 Blocks

Block TypeSupportedNotion client requiredAvailable inNotes
Text✅ Yes@notion-render/client<span>
Bookmark✅ Yes@notion-render/clientUsesurl-metadata to generate bookmark
Breadcrumb❌ MissingEmbedded preview of external URL
Bulleted List Item✅ Yes@notion-render/client<ul><li>
Callout✅ Yes@notion-render/client<blockquote>
Child database❌ Missing
Child page❌ Missing
Code✅ Yes@notion-render/client
Column List✅ Yes⚠ Yes@notion-render/client<div>
Column✅ Yes⚠ Yes@notion-render/client<div>
Divider✅ Yes@notion-render/client<hr>
Embed❌ Missing
Equations❌ Missing
Files❌ Missing
Heading 1✅ Yes@notion-render/client<h1>
Heading 2✅ Yes@notion-render/client<h2>
Heading 3✅ Yes@notion-render/client<h3>
Toggle Heading 1✅ Yes⚠ Yes@notion-render/client<details><summary><h1> Requires Notion client
Toggle Heading 2✅ Yes⚠ Yes@notion-render/client<details><summary><h2> Requires Notion client
Toggle Heading 3✅ Yes⚠ Yes@notion-render/client<details><summary><h3> Requires Notion client
Image✅ Yes@notion-render/client<fig><img>
Link preview❌ Missing
Mention✅ Yes@notion-render/client<span> Returns plain text (e.g. @John Doe)
Numbered List Item✅ Yes@notion-render/client<ol><li>
Paragraph✅ Yes@notion-render/client<p>
PDF❌ Missing
Quote✅ Yes@notion-render/client<blockquote>
Synced block❌ Missing
Table🔶 Not fully supported@notion-render/client<table> Header row and column not supported
Table Row🔶 Not fully supported@notion-render/client<tr> Header row and column not supported
Table of contents❌ Missing
Template❌ Deprecated
To do✅ Yes@notion-render/client<ul><li>
Toggle✅ Yes⚠ Yes@notion-render/client<details>
Video❌ Missing

🔧 Extend

Custom renderer

You can create custom renderers to handle custom Notion plugins and override existing blocks.

import{NotionRenderer,createBlockRenderer}from'@syneki/notion-render';constparagraphRenderer=createBlockRenderer<ParagraphBlockObjectResponse>('paragraph',(data,renderer)=>{return`<p>${renderer.render(...data.paragraph.rich_text)}</p>`;});constrenderer=newNotionRenderer({renderers:[paragraphRenderer],});

Contributing

I'd love for you to contribute to this project. You can request new features by creating an issue, or submit a pull request with your contribution.

Licence

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

A Javascript library to transform Notion API RichText object into HTML

Resources

License

Stars

Watchers

Forks

Packages

No packages published

[8]ページ先頭

©2009-2025 Movatter.jp