ipynb2md
Introduction
ipynb2md,意如其名,是一个简单、快速、美观的将 jupyter notebook 转为 markdown 的工具脚本。
最近在使用 Jupyter Notebook 工作,希望转为 Markdown 形式以便在博客中分享。使用了官方的 nbconvert 后,效果不太满意。于是自己写了一个转换脚本,满足自己的强迫症。
Github 地址:https://github.com/Cloudy1225/ipynb2md
ipynb2md vs nbconvert --to markdown:
优势:
- 不依赖第三方库,只用 Python 内置库即可
- 加注释只有三百多行,比
nbconvert
更快 - 增加了更多的 HTML 块,更加与原 Notebook 文件相似
劣势:
- 只能将
.ipynb
转为.md
,而nbconvert
的还可以转 PDF、HTML、LaTex等等 - 没有
nbconvert
方便,nbconvert
可以配置环境变量,在任意路径使用
Install
直接复制源码 ipynb2md.py
.
或者:
git clone https://github.com/Cloudy1225/ipynb2md.git
仓库里面有例子 example.ipynb
Use it
在终端中使用,传递 .ipynb
文件路径即可:
python ipynb2md.py example/example.ipynb