Add lower level headings to the export about notebook-as-pdf HOT 5 CLOSED

You're right - it gets unwieldy past a certain depth.

It's probably a lot more effort, but I like how sphinx handles this by having a maxdepth parameter. So in this case, it could be an optional argument, with the default set at a reasonable H2 or H3 ?

from notebook-as-pdf.

Level 2 headings are now included (see aaa8565).

from notebook-as-pdf.

RE above, I've also opened an issue in the jupyterbook repo about possibly integrating this export method there.

Use-case

Below are two PDF exports from an example jupyter book that is not mine (ThreatHunter Playbook):

1. Standard Jupyterbook PDF export

2. Using notebook as PDF extension to export

from notebook-as-pdf.

What do you think of including (only) h1 and h2 tags?

The reason i am hesitant to add "all headings" is that I don't enjoy the pdf table-of-contents UX when you have lots of levels of "folding". It makes it super hard to see things and read the titles without making the TOC part of the UI wider.

Another option I just thought of is to not use the "nesting" feature of a PDF TOC but instead prefix the headings with something like (nothing) for h1, · for h2, ·· for h3, etc. So an ASCII character to indicate "nesting" level.

from notebook-as-pdf.

Amazing! Nice work!

from notebook-as-pdf.