NoteTrail

convert markdown directory to notions.

将 markdown (*.md) 目录结构的电子书导入到 notion 中.

项目可以用来做什么?

• markdown目录结构的书导入至notion
• hexo博客迁移至notion

样例展示: 我的notion主页

关于使用

项目使用notion api来实现脚本导入.

使用项目之前需要预设环境变量:

• NOTION_TOKEN: 从创建 api integrations 用户, 并将其 token 作为环境变量值
• (可选)项目使用阿里云来存储图片, 所以需要阿里云对应的oss调用 AccessKey, 阿里云OSS, AccessKey管理.
  • ALI_OSS_AK: 本变量的值对应 AccessKey ID
  • ALI_OSS_SK: 本变量的值对应 AccessKey Secret.
  • ALI_BUCKET: bucket的url, 如 'https://example-oss-bucket.oss-cn-region.aliyuncs.com/'

markdown目录结构

使用方法

在 ./notetrail/book_processor.py 中填入对应的参数.

关于样例

github	notion
ddd笔记	notion样例
you-dont-know-js	notion样例
how-to-cook	notion样例
sdn	notion样例

hexo博客迁移至notion

!!! 迁移请确保语法符合markdown规则 !!!

对于不符合markdown语法规则的, 可以在输出的日志中找到对应的文件.

使用方法

在 ./notetrail/hexo/hexo.py 中填入对应的参数.

如果 md 文件的标头中存在 "notion: false" 的配置, 则将会跳过该文件. 对于不想被收录的, 或者因使用了非notion语法而无法被解析的, 可以使用该方法.

样例展示

博客地址

notion地址

TODO

• blocks
  • code
  • p
  • ul
  • ol
  • headers(h1\h2\h3...)
  • rich-text
  • picture
  • table
  • html block
  • html span
• add logger
• add sqlite to store notion-db __ ebook map relation, for update
• refactor block class
• pic management (oss)
• page version control
• toc
• more properties (unread, pinned, ...)
• block render class and validate block
• catch failed block render and log
• 使用命令行进行操作