Changelog

v1.4.0 (2026-04-07)

• Add Mermaid diagram rendering.
• Add labels via Kramdown’s attributes.

v1.3.0 (2026-04-5)

• Added admonitions support using the GitHub Markdown-style syntax.
• When built with GitHub pages, automatically detect and add GH link, “edit on GitHub” link, and commit hash link.
• Added “copy code to clipboard” buttons to code blocks.
• Added heading anchor links on hover.
• Added option to add external links in the navigation bar.
• Add button styling via links with additional attributes.
• Added social media previews/metadata/images.
• Added more SEO related metadata.

v1.2.0 (2026-03-15)

• Sync theme with the upstream version from MkDocs v1.6.1, which is synced to the original Read the Docs theme to v1.2.
  • Includes following commits since last time it was synced:
    • mkdocs/mkdocs@4d1d1c1
    • mkdocs/mkdocs@fa52d3a
    • mkdocs/mkdocs@cdf8a26
    • mkdocs/mkdocs@82bd8ba
    • mkdocs/mkdocs@f3f6631
    • mkdocs/mkdocs@97440ca
    • mkdocs/mkdocs@ea1c6c4
    • mkdocs/mkdocs@3c3670d
    • mkdocs/mkdocs@b4c02e5
    • mkdocs/mkdocs@c4db02b
    • mkdocs/mkdocs@c070dd0
    • mkdocs/mkdocs@94544bd
  • Doesn’t include:
    • mkdocs/mkdocs@a012d2e
      • Breadcrumbs didn’t need this change
    • mkdocs/mkdocs@cc88b5a, mkdocs/mkdocs@e254d4b, and mkdocs/mkdocs@8b0971c
      • Jinja2 updates not applicable to Jekyll templating system
    • mkdocs/mkdocs@ca9c8c, and mkdocs/mkdocs@49d02e4
      • This feature has been overwritten by this theme version with deeper GH integration.
    • mkdocs/mkdocs@32d8c3a
      • Feature skipped for config simplicity.
    • mkdocs/mkdocs@da35dca and mkdocs/mkdocs@da35dca
      • Navigation reimplemented for Jekyll Liquid templates, not needed.
  • There was also a large number of commits updating the translations, which are not supported in this Jekyll theme version.

v1.1.0 (2026-03-13)

• Sync theme with the upstream version from MkDocs v1.2.
  • Includes following commits since last time it was synced:
    • mkdocs/mkdocs@273e3ba
    • mkdocs/mkdocs@63b3eb5
    • mkdocs/mkdocs@dd903d3
    • mkdocs/mkdocs@1beaf22
    • mkdocs/mkdocs@eb31d4c
  • Doesn’t include:
    • mkdocs/mkdocs@34a425e
      • Not needed with the Jekyll changes
    • mkdocs/mkdocs@e1b77ab
      • Theme localisation not supported
    • mkdocs/mkdocs@a8ec4b6
      • Theme localisation not supported
    • mkdocs/mkdocs@80feaf0
      • GAnalytics change within MkDocs, not needed.
• Added a test script to create screenshots of the theme and compare them with the previous version, to easily spot visual changes.

v1.0.0 (2026-02-25)

Initial stable release.