Jupyter Notebook 转 Mardown工具

ipynb2md

Introduction

ipynb2md，意如其名，是一个简单、快速、美观的将 jupyter notebook 转为 markdown 的工具脚本。

最近在使用 Jupyter Notebook 工作，希望转为 Markdown 形式以便在博客中分享。使用了官方的 nbconvert 后，效果不太满意。于是自己写了一个转换脚本，满足自己的强迫症。

Github 地址：https://github.com/Cloudy1225/ipynb2md

ipynb2md vs nbconvert --to markdown：

优势：

1. 不依赖第三方库，只用 Python 内置库即可
2. 加注释只有三百多行，比 nbconvert 更快
3. 增加了更多的 HTML 块，更加与原 Notebook 文件相似

劣势：

1. 只能将 .ipynb 转为 .md，而 nbconvert 的还可以转 PDF、HTML、LaTex等等
2. 没有 nbconvert 方便，nbconvert 可以配置环境变量，在任意路径使用

Install

直接复制源码 ipynb2md.py .

或者：

git clone https://github.com/Cloudy1225/ipynb2md.git

仓库里面有例子 example.ipynb

Use it

在终端中使用，传递 .ipynb 文件路径即可：

python ipynb2md.py example/example.ipynb

Example

点此查看示例
示例 Notebook 源码