jupyter / jupyter/notebook

Notebook to PDF converting forces markdown title numbering

Open
#7,722 5 comments 0 reactions 0 assignees View on GitHub
bug
Dominant language
Jupyter Notebook
Stars
13.3k
Forks
5.8k
Avg merge
6d 11h
Merged PRs (30d)
7

Description

## Description

Converting a notebook with titles in the markdown sections to PDF adds odd numbering to **all** titles.
The quickest way to disable this feature is to append `{.unnumbered}` / `{-}` attribute to the title row, but they are visible in the notebook.

All other methods, such as using custom LaTeX templates, are painful and do not work.

Image

## Reproduce

1. Create a new Notebook
2. Add two markdown sections
3. Create simple titles
4. Export to PDF via _File / Save and Export Notebook As / PDF_
5. The PDF contains titles with the numbering

## Expected behavior

Numbers must be where I put them.

## Context

- Operating System and version: Linux Ubuntu 24.04
- Browser and version: Latest Chrome and Firefox
- Jupyter Notebook version:
```bash
jupyter --version
Selected Jupyter core packages...
IPython : 9.5.0
ipykernel : 6.30.1
ipywidgets : not installed
jupyter_client : 8.6.3
jupyter_core : 5.8.1
jupyter_server : 2.17.0
jupyterlab : 4.4.7
nbclient : 0.10.2
nbconvert : 7.16.6
nbformat : 5.10.4
notebook : 7.4.5
qtconsole : not installed
traitlets : 5.14.3
```
Tested in the clean Jupyter installation in the dedicated venv.

Contributor guide

Open the contributing guide

Research direction

Start by reproducing the export through File / Save and Export Notebook As / PDF in the reported clean Jupyter installation, then inspect the notebook PDF export path and its LaTeX handling. Done means headings retain only the numbers entered by the author without requiring visible {.unnumbered} or {-} attributes.

Written by the indexing model from the issue text.

Assessment

Tech stack
jupyter-notebook, latex
Domain
backend, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.