Notebook Splitting

split splits Jupyter notebooks by writing each cell type (markdown, code, and raw) to its own notebook.

Unless in quiet mode, split shows cell counts: markdown, code, raw, and total.

Result File Names

The results of splitting notebook nb.ipynb are named:

• nb-markdown.ipynb

• nb-code.ipynb

• nb-raw.ipynb

When a particular type of cell does not occur, that result notebook is not written.

The result name additions can be adjusted in the configuration file by setting split_markdown_result_name, split_code_result_name, and split_raw_result_name; see Configuration Files.

Options

The following options are supported by split:

-t TYPES, --split-cell-types TYPES
                      comma-separated list of cell types to split (default:
                      'markdown,code,raw')

JSON Output

See Write JSON Output for general information about JSON output.

split produces the following members in the JSON output:

Name	Value
"CT"	count of cells with type CT

Cell types distinguished: markdown, code, raw

Examples

Split notebook test.ipynb in verbose mode without writing the results:

$ nbtb split test.ipynb -v -n
Dry run (no files written)
Options for nbsplit:
  (None)

::::::::::::::
test.ipynb
::::::::::::::
Split cell statistics:
          12 code
           7 markdown
           0 raw
          19 total
No files written

Notebooks processed: 1