从脚本到Notionmd2notion Python API实战教程【免费下载链接】md2notionA better Notion.so Markdown importer项目地址: https://gitcode.com/gh_mirrors/md/md2notionmd2notion是一款强大的Markdown到Notion导入工具它解决了Notion官方导入器的诸多痛点提供更精准的格式转换和更灵活的导入方式。本教程将带你快速掌握如何通过Python API使用md2notion轻松实现Markdown文件到Notion页面的完美迁移。✨ md2notion核心优势相比Notion官方Markdown导入功能md2notion带来了多项关键改进精准代码块处理保留原始编程语言高亮格式排版更规范灵活导入目标可指定任意Notion页面作为导入目标而非默认根目录本地图片自动上传自动识别并上传Markdown中的本地图片引用HTML内容保留完整支持HTML内嵌内容需启用--html-img参数Frontmatter支持保留Markdown文件的Frontmatter元数据列表嵌套优化正确处理多层级列表结构保持原始排版逻辑 快速安装指南使用pip即可完成安装支持Python 3.6及以上版本pip install md2notion如需从源码安装可克隆仓库后执行 setup.pygit clone https://gitcode.com/gh_mirrors/md/md2notion cd md2notion python setup.py install 基础API使用教程1. 初始化Notion客户端首先需要获取Notion的token_v2和目标页面URL。token_v2可从浏览器Cookie中获取目标页面URL则是你希望作为导入父节点的Notion页面链接。from notion.client import NotionClient from notion.block import PageBlock from md2notion.upload import upload # 初始化Notion客户端 client NotionClient(token_v2你的token_v2值) # 获取目标页面 target_page client.get_block(https://www.notion.so/你的页面URL)2. 基本导入操作使用upload函数可将Markdown文件内容导入到Notionwith open(你的文档.md, r, encodingutf-8) as md_file: # 创建新页面作为导入目标 new_page target_page.children.add_new(PageBlock, title导入文档标题) # 执行导入 upload(md_file, new_page)这段代码会在目标页面下创建一个新的子页面并将Markdown内容转换为Notion块结构。3. 高级配置选项md2notion提供多种自定义导入方式满足不同场景需求图片路径转换当Markdown中的图片路径需要特殊处理时如Hexo博客的图片组织方式可自定义图片路径转换函数def custom_image_path(image_path, md_file_path): 将图片路径转换为实际存储位置 return Path(md_file_path).parent / images / Path(image_path) # 使用自定义图片路径函数 upload(md_file, new_page, imagePathFunccustom_image_path)分步处理转换结果如需在导入前修改转换结果可使用convert和uploadBlock函数分步处理from md2notion.upload import convert, uploadBlock # 先转换Markdown为Notion块描述符 rendered_blocks convert(md_file) # 处理块描述符例如修改内容、过滤特定块等 for block in rendered_blocks: if block[type].__name__ CodeBlock: # 自定义代码块处理 block[language] python # 逐个上传处理后的块 for block in rendered_blocks: uploadBlock(block, new_page, md_file.name) 实用场景示例Hexo博客导入以下示例展示如何将Hexo博客文章批量导入到Notion包含Frontmatter处理和图片路径转换import io import os.path import glob from pathlib import Path from notion.block import PageBlock from notion.client import NotionClient from md2notion.upload import upload client NotionClient(token_v2你的token_v2值) target_page client.get_block(https://www.notion.so/你的博客页面URL) # 遍历所有Hexo文章 for md_path in glob.glob(../source/_posts/*.md, recursiveTrue): with open(md_path, r, encodingutf-8) as md_file: # 处理Frontmatter md_content md_file.read() content_chunks md_content.split(---) processed_content fyaml\n{content_chunks[1]}\n\n\n{content_chunks[2]} # 创建文件对象 processed_file io.StringIO(processed_content) processed_file.name md_path # 保留原始路径用于图片处理 # 创建Notion页面 page_title os.path.basename(md_path)[:40] new_page target_page.children.add_new(PageBlock, titlepage_title) # 自定义图片路径处理 def hexo_image_path(img_path, md_file_path): return Path(md_file_path).parent / Path(md_file_path).stem / Path(img_path) # 执行导入 upload(processed_file, new_page, imagePathFunchexo_image_path) print(f已导入: {page_title})️ 命令行工具使用除了Python APImd2notion还提供命令行工具快速导入# 基本用法 python -m md2notion [token_v2] [页面URL] [Markdown文件路径] # 清除同名页面后导入 python -m md2notion [token_v2] [页面URL] [文件路径] --clear-previous # 追加内容到现有页面 python -m md2notion [token_v2] [页面URL] [文件路径] --append # 启用HTML图片上传 python -m md2notion [token_v2] [页面URL] [文件路径] --html-img 扩展与定制md2notion的核心渲染逻辑在 md2notion/NotionPyRenderer.py 中实现通过继承该类可以定制Markdown到Notion块的转换规则。例如添加自定义代码高亮、扩展Markdown语法支持等。主要扩展点包括自定义块类型转换扩展语法解析器自定义样式处理⚠️ 注意事项API兼容性本项目依赖notion-py库请注意Notion API变更可能导致的兼容性问题文件大小限制单次导入大文件可能需要分块处理网络连接图片上传需要稳定的网络连接权限控制确保Notion页面有足够的编辑权限通过本教程你已经掌握了md2notion的核心使用方法。无论是个人笔记管理还是团队文档迁移md2notion都能帮助你轻松实现Markdown到Notion的无缝转换让内容管理更加高效【免费下载链接】md2notionA better Notion.so Markdown importer项目地址: https://gitcode.com/gh_mirrors/md/md2notion创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考