How to regain functionality from the removed level 1 headline hack?

[SupImDos]

Hi,

I'm going through the process of updating my documentation from mkdocs-material 8.x -> 9.x.

One of the changes I've found is that the header on my index page is no longer detected (as it is below my project logo), and as such the partials/content.html is adding an additional <h1> tag with the page name.

This can be traced back to commit b95dffa, where the functionality for checking the content for an existing <h1 tag was removed.

I completely understand the change, and I don't expect this will be reverted. I just wanted to ask if there's a simple way (without overriding partials/content.html) that I can regain this functionality and remove the automatic <h1>.

For reference, some screenshots below show before and after this change.
Before

After

Thanks!

[squidfunk]

Thanks for reporting. The hack was necessary when I started with Material for MkDocs, because MkDocs provided no way of knowing whether an h1 headline was set or not. However, the use case you describe definitely makes sense: as long as the author provides an h1 tag (in Markdown or HTML), the headline should not be added to the page's content.

We can revert the relevant section in b95dffa and keep the hack, as it offers more flexibility. However, we can keep the logic in partials/toc.html, as the table of contents only includes Markdown headlines anyway. Would you like to craft a PR?

[SupImDos]

Thanks @squidfunk, that sounds great.

Would you like to craft a PR?

I've created a PR for this change here: #5056. I think I've understood correctly, but let me know if I misunderstood something and you had something else in mind.

[SupImDos]

Fixed in #5056, released in v9.0.13. This discussion can be marked as solved.