Alter heading levels when including mardown files?

[thedamon]

I love how easy it is to include markdown files, and I want to include README files from different files in a monorepo, into a single page, but because each readme correctly has its name as the h1, they do not show in the sidebar, which will only show h2 and up.

I think outside of this usecase, the ability to increase/decrease heading level would generally make reusing blocks of text in different contexts easier as well.

Something like:

<!--@include: @/../packages/formatting/README.md(h+1)-->
<!--@include: @/../packages/validation/README.md(h+1)-->
<!--@include: @/../packages/analytics/README.md(h+1)-->

to increase each h1 to an h2, etc.

Not sure how well this would play with the existing functionality as it's clearly more involved, but I think this could be really useful in a lot of ways .. also curious other ways to theoretically achieve this without having to edit all the source markdowns to be incorrect on their own...