Markdown 3.2 and Pymdown Extensions 6.3 Released with code block changes

I checked that…

• … the documentation does not mention anything about my idea
• … to my best knowledge, my idea wouldn’t break something for other users
• … there are no open or closed issues that are related to my idea

Description

Markdown 3.2 and Pymdown Extensions 6.3 were just released. This forces Pygments code blocks to always be wrapped in code blocks: <div><pre><code></code></pre></div>. This is different that the previous <div><pre></pre></div> convention.

Pymdown already accounts for this in its own documents, and all that was needed is:

  /* Handled pre with wrapped code */
  div.codehilite > pre {
    padding: 0;
  }

If you don’t get to it first, I’ll try to come up with a pull, but wanted to at least create an issue now.

[facelessuser]

Okay, I tested this out in a virtual environment. If you install just mkdocs-material, you will get all the needed requirements and things will work. If you install mkdocs mkdocs-material, mkdocs will be installed first and install the latest Markdown which is incompatible, then it will install mkdocs-material which will cause a failure as the version of Markdown is wrong. For whatever reason, pip will not correct this.

So either just install mkdocs-material and other dependecies not already covered, or ensure you install the correct pymdown-extensions and markdown first:

python -m pip install "pymdown-extensions<6.3" "markdown<3.2" mkdocs mkdocs-material

[waylan]

In case you missed it, as per mkdocs/mkdocs#1970, the next release of MkDocs will require Markdown 3.2. Just thought you guys would want to know that so you can plan for it.