@vrerv/md-to-notion
Version:
An upload of markdown files to a hierarchy of Notion pages.
58 lines (39 loc) • 2 kB
Markdown
<div align="center">
<h1>MD to Notion</h1>
<p>
<b>An upload of markdown files to a hierarchy of Notion pages.</b>
</p>
<br>
</div>
[](https://www.npmjs.com/package/@vrerv/md-to-notion)
[🇰🇷 (한국어)](./README_KO.md) | [🇬🇧 (English)](./README.md)
## Features
- Upload markdown files to Notion pages with hierarchy
- Update existing pages if the file name is same. only update changed blocks.
- Replace local link to Notion page link automatically
- Replace local link using custom replacement
- Delete(archive) notion pages that does not exist(deleted files) in local (not to delete by default)
## Usage
You need to get Notion API secret and page ID to upload your markdown files.
Follow this [guide](./docs/configure-notion.md) to get the secret and page ID.
See [Example Project](./examples/example-project) for live example.
### CLI
```bash
npx @vrerv/md-to-notion --help
```
Update all markdown files under the current directory to Notion page
```bash
npx @vrerv/md-to-notion -t <notion-api-secret> -p <notion-page-id> .
```
This project markdown files are also published as Notion pages by this package using [GitHub Actions](./docs/github-actions.md).
You can see the [md-to-notion Notion Page](https://vrerv.notion.site/MD-To-Notion-e85be6990664452b8669c72d989ce258)
## Requirements
This package supports the following minimum versions:
- Runtime: `node >= 16`
- Type definitions (optional): `typescript >= 4.5`
Earlier versions may still work, but we encourage people building new applications to upgrade to the current stable.
## References
- [notion-sdk-js](https://github.com/makenotion/notion-sdk-js)
- [martian](https://github.com/tryfabric/martian)
- [markdown2notion](https://github.com/Rujuu-prog/markdown2notion) - Initially I tried to use this but need more feature for my use case