kakakakakku blog

Weekly Tech Blog: Keep on Learning!

jupyter nbconvert コマンドを使って Notebook を変換する

jupyter nbconvert コマンドを使うと Jupyter Notebook を Python コード / PDF / HTML などに変換できる.指定できるフォーマットの一覧は GitHub に載っている.また Jupyter Notebook で使える Download as メニューも同じ仕組みを使っている.

github.com

Python コード

Jupyter Notebook を「Python コード」に変換するなら --to script オプションを使う.例えば,MLOps として「データサイエンティスト」の実装した Jupyter Notebook を「機械学習エンジニア」が Python コードにリファクタリングするときに使えたりする.

$ jupyter nbconvert --to script xxx.ipynb

PDF

Jupyter Notebook を「PDF」に変換するなら --to pdf オプションを使う.TeX に依存しているため,環境によってはエラーになる可能性もある.

$ jupyter nbconvert --to pdf xxx.ipynb

その場合は --to webpdf オプションを使って,PyppeteerChromium 経由で「PDF」に変換する選択肢もある.

$ jupyter nbconvert --to webpdf xxx.ipynb

HTML

Jupyter Notebook を「HTML」に変換するなら --to html オプションを使う.画像も <img> タグになる.

$ jupyter nbconvert --to html xxx.ipynb

あわせて --template オプションを使うと HTML のデザインも変更できる.デフォルトは lab となる.また --template lab オプションを使う場合は --HTMLExporter.theme dark オプションで黒ベースのデザインにも変更できる.

$ jupyter nbconvert --to html xxx.ipynb --template lab
$ jupyter nbconvert --to html xxx.ipynb --template lab --HTMLExporter.theme light
$ jupyter nbconvert --to html xxx.ipynb --template lab --HTMLExporter.theme dark
$ jupyter nbconvert --to html xxx.ipynb --template classic
$ jupyter nbconvert --to html xxx.ipynb --template basic

関連記事

kakakakakku.hatenablog.com

kakakakakku.hatenablog.com