Markdown in HTML blocks does not render after deployment (local normal)

[pyheight]

Problem Description

When testing with local mkdocs serve, Markdown rendering in HTML blocks works fine:

<center>
[:material-rocket-launch: Quick Start](./download/installation/#download-latest-version){: .md-button .md-button--primary }
[:material-dots-horizontal-circle: Learn More](./about/project-overview/){: .md-button }
</center>

<center>
  <span style="font-size:1.6em;color:#ff6b6b">:material-heart-outline:</span> 
  <span style="font-size:1.4em;color:#ff8e8e">:material-heart-half-full:</span> 
  <span style="font-size:1.2em;color:#ffaaaa">:material-heart:</span> 
  Made with Love 
  <span style="font-size:1.2em;color:#ffaaaa">:material-heart:</span> 
  <span style="font-size:1.4em;color:#ff8e8e">:material-heart-half-full:</span> 
  <span style="font-size:1.6em;color:#ff6b6b">:material-heart-outline:</span>
</center>

However, when deployed to GitHub Pages, these buttons appear as the original Markdown text instead of the rendered buttons.

Confirmed to enable md_in_html extensions:

markdown_extensions:
  - md_in_html

Related screenshots

ADDITIONAL INFORMATION

https://github.com/pyheight/ttk-file-explorer
https://pyheight.github.io/ttk-file-explorer/

[kamilkrzyskow]

Hi @pyheight,

When testing with local mkdocs serve, Markdown rendering in HTML blocks works fine:

Interesting, could you show the results of these commands? Maybe you have some special behaviour. Screenshots look like Windows 7, but I guess it's only a theme, right? 👀

python --version
pip freeze

As for the fix, when you mix md_in_html you have to add markdown attribute to every [block-level] HTML tag in the DOM tree chain.
Extension docs: https://python-markdown.github.io/extensions/md_in_html/#nesting
Example in the theme docs: https://squidfunk.github.io/mkdocs-material/reference/annotations/#in-everything-else

<center markdown>
  <span style="font-size:1.6em;color:#ff6b6b">:material-heart-outline:</span> 

Also better keep the indent flat, as Python Markdown parser could see multiple spaces as a start of a quote or list.

<center markdown>
<span style="font-size:1.6em;color:#ff6b6b">:material-heart-outline:</span> 

EDIT: Fixed the answer thanks to Isaac below 🫡

[facelessuser]

More specifically, markdown attribute must be added to every "block" element you wish to parse. Inline elements are parsed automatically.

As to why it might work locally and not other places? This can occur if you are using different Python Markdown versions. For a while "center" was incorrectly treated as a inline element, but in version 3.8, this was changed to properly treat it as a block element, which now requires the markdown attribute.

[kamilkrzyskow]

Ah ok, so in this case <span> doesn't have to use markdown, as only center is a block wrapper. Thanks for stepping in.

[pyheight]

@kamilkrzyskow, thank you very much for your professional guidance!
The two points you pointed out (the markdown attribute declaration and the indentation issue) completely solved my confusion.

Here is the environmental information and specific implementation you request:

$ python --version
Python 3.8.0

$ pip freeze
Markdown==3.7
mkdocs==1.6.1
mkdocs-autorefs==1.2.0
mkdocs-get-deps==0.2.0
mkdocs-git-revision-date-plugin==0.3.2
mkdocs-material==9.6.15
mkdocs-material-extensions==1.3.1
mkdocs-mermaid2-plugin==1.2.1
mkdocs-static-i18n==1.3.0
mkdocstrings==0.26.1
mkdocstrings-python==1.11.1

As for the system environment, what you see is indeed Windows 7.

Effect after repair:

---

🙏 Thank you again, your reply gave me a deeper understanding of the processing logic of the Markdown parser, especially the key point where container elements need to declare markdown.

[kamilkrzyskow]

Python 3.8 is EOL, and MkDocs slowly but surely will at some point drop support for it, and the most recent versions will stop working on Windows 7.
Consider switching to at least Windows 10, which will also become EOL this year, but should be getting security updates to at least 2028.
If newer versions of Windows aren't a possibility for you, then consider switching to Linux 🫡