Is there a way to render HTML tags in the table of contents (toc)?

[Lexachoc]

For example, I have this in the markdown:

Silicon dioxide, SiO₂

but in the table of contents (toc), it is displayed as Silicon dioxide, SiO2
however I would like the <sub> tag work also in the toc.

I tried to add | safe
into this line {{ toc_item.title }}

<!-- Table of contents item -->
<li class="md-nav__item">
  <a href="{{ toc_item.url }}" class="md-nav__link">
    <span class="md-ellipsis">
      {{ toc_item.title}}
    </span>
  </a>

<!-- Table of contents item -->
<li class="md-nav__item">
  <a href="{{ toc_item.url }}" class="md-nav__link">
    <span class="md-ellipsis">
      {{ toc_item.title | safe}}
    </span>
  </a>

but it doesn't work.
I'm not sure if it's a bug or if it's intentional that the HTML tags for toc are not taken into account.

Does anyone have any ideas on how to do this? Thank you!

[squidfunk]

MkDocs by default does not support it, but if you enable the built-in typeset plugin, the table of contents and navigation allow for HTML to be rendered. Note that you need to sponsor the project to get access to the plugin, as it is currently incubating in Insiders.

If you have access to Insiders, add the following to mkdocs.yml to enable the plugin:

plugins:
  - typeset

See it in action in our plugins documentation, where we use it for settings.