Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adjust heading level from markdown files #117

Open
mbs44 opened this issue Aug 28, 2024 · 1 comment
Open

Adjust heading level from markdown files #117

mbs44 opened this issue Aug 28, 2024 · 1 comment

Comments

@mbs44
Copy link

mbs44 commented Aug 28, 2024

Hi

I have a bigger technical documentation generated from real world application in mkdocs format with material design theme. I have used print-site plugin quite successfully but one problem I couldn't solve.

I have a structure of folders of depth 3 or 4 and folders contain markdown files. I'm using heading 1 and often heading 2 inside markdown files. Everything works and looks nicely on the original multi file web page.

But if I generate everything into single page file then surprisingly the heading levels from the individual markdown files stay the same. E. g. in the output print_page.html I have heading 3 generated from the folder structure and then follows the first heading 1 from the individual markdown file which doesn't look nice. I would expect heading 4 in this case, so the heading level from markdown file should be shifted by the current depth of folder structure.

For example when I generate the pdf file using with-pdf plugin the headings from markdown files are adjusted correctly and the numbering is correct too.

Am I missing some setting or doing it wrongly? On the other hand I would expect this should be the default behavior.

@nurse-the-code
Copy link

Can you provide some examples (i.e. relevant file structure, markdown headings and screenshot of PDF output headings) so it is a little clearer what the problem is?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants