notebook.split_header_cells

Goal

• Format the markdown cells to match

Workflow

Split Markdown Cells

• Make sure that each markdown cell in a Jupyter notebook contains at most one header and some text, but not more than one header
  • Bad (there are 3 headers in the same cell: one H1, one H2, one H3)

    # %% [markdown]
    # Part 3: Composition Examples
    
    ## Example 1: Minimal End-to-End Workflow
    
    Rain → Sprinkler → Grass Wet
    
    ### Mental Model
    

  • Good (each header is in a different cell)

    # %% [markdown]
    # Part 3: Composition Examples
    
    # %% [markdown]
    ## Example 1: Minimal End-to-End Workflow
    
    Rain → Sprinkler → Grass Wet
    
    # %% [markdown]
    ### Mental Model
    

  • Do not change the content of the markdown text besides splitting cells into multiple ones

Remove Empty Lines

• Remove empty lines at the beginning or end of a markdown cell
  • Bad (there are two headers in the same cell, one H1 and one H2)

    
    # %% [markdown]
    # Part 3: Composition Examples
    
    
    

  • Good (each header is in a different cell)

    # %% [markdown]
    # Part 3: Composition Examples
    

Important

• Do not change or remove any Python code cell
• At the end of the transformation, run jupytext --sync to update the Python paired notebook, following the conventions in # Setup and Initialization → ## Utilities vs. Notebook Responsibilities in .claude/skills/notebook.rules.md