notion-to-slides

A simple npm package to convert a Notion page to a Marp Slides presentation.

H1 and H2 Heading in the notion page will be used as the slide title, and the rest of the content will be used as the slide body.

You can see the usage from getting started slides, which is also created by this package. The original notion page is here.

Demo Movie

https://github.com/user-attachments/assets/064ef684-e19f-4eae-95bf-e921f82015f5

Usage

1. Prepare the notion token

1. Create an integration token in Notion
2. Open the Notion page you want to convert
3. Add your integration to the page

2. Set the notion token to the environment variable

$ export NOTION_TOKEN=[your notion token]

3. Install and run the script

$ npx @kromiii/notion-to-slides --url [your notion page url] --theme [marp theme] --port [port number]

You can change the theme by setting the --theme option. The default theme is default.

Available themes are: default, uncover, and gaia. See Marp Core Themes for more details.

4. Check and export the slides as pdf

Once the script is finished, it will open the browser with the slides. You can check the slides by clicking the "Print" button (cmd + P on Mac). Then you can export the slides as pdf.

Example

$ npx @kromiii/notion-to-slides --url https://www.notion.so/khiroyuki1993/CTOA-LT-4-c2769d7bc90a4f428adae7a2192d258a --theme uncover --port 8080

Options

| Option | Description | Default | Required | | --- | --- | --- | --- | | --url | The Notion page URL to convert | | required | | --theme | The Marp theme to use | default | optional | | --port | The port number to use | 8080 | optional |

Development

$ git clone
$ npm i
$ npm run start [your notion page url] -- --port [port number] -- --theme [marp theme]

License

MIT