mdformat-mkdocs 5.2.0b0__tar.gz → 5.2.0b2__tar.gz

{mdformat_mkdocs-5.2.0b0 → mdformat_mkdocs-5.2.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mdformat_mkdocs
-Version: 5.2.0b0
+Version: 5.2.0b2
 Summary: An mdformat plugin for mkdocs and Material for MkDocs
 Keywords: markdown,markdown-it,mdformat,mdformat_plugin_template
 Author: kyleking
@@ -32,6 +32,7 @@ Requires-Dist: mdformat-hooks>=0.1.0 ; extra == 'recommended-mdsf'
 Requires-Dist: mdformat-simple-breaks>=0.0.1 ; extra == 'recommended-mdsf'
 Requires-Dist: mdformat-wikilink>=0.2.0 ; extra == 'recommended-mdsf'
 Requires-Dist: beartype>=0.21.0 ; extra == 'test'
+Requires-Dist: hypothesis>=6.100.0 ; extra == 'test'
 Requires-Dist: pytest>=9.0.1 ; extra == 'test'
 Requires-Dist: pytest-beartype>=0.2.0 ; extra == 'test'
 Requires-Dist: pytest-cov>=7.0.0 ; extra == 'test'
@@ -79,6 +80,23 @@ Supports:
 - [Python Markdown "Snippets"\*](https://facelessuser.github.io/pymdown-extensions/extensions/snippets)
     - \*Note: the markup (HTML) renders the plain text without implementing the snippet logic. I'm open to contributions if anyone needs full support for snippets
 
+### Features with Implicit Support
+
+The following MkDocs/Material/PyMdown syntax passes through mdformat-mkdocs unchanged — it is not modified or corrupted, but it is also not actively normalized:
+
+- [PyMdown Keys](https://facelessuser.github.io/pymdown-extensions/extensions/keys/) — `++ctrl+alt+del++` (not a markdown construct, preserved as-is)
+- [PyMdown Critic Markup](https://facelessuser.github.io/pymdown-extensions/extensions/critic/) — `{--deleted--}`, `{++added++}`, `{~~old~>new~~}`, `{==highlight==}`, `{>>comment<<}`
+- [PyMdown Highlight](https://facelessuser.github.io/pymdown-extensions/extensions/mark/) — `==marked text==`
+- [PyMdown Caret / Tilde](https://facelessuser.github.io/pymdown-extensions/extensions/caret/) — `H^2^O`, `CH~3~OH`
+- [PyMdown Emoji](https://facelessuser.github.io/pymdown-extensions/extensions/emoji/) — `:smile:`, `:material-icon:`
+- [PyMdown InlineHilite](https://facelessuser.github.io/pymdown-extensions/extensions/inlinehilite/) — language hints inside backtick spans (`:::python code`) are never modified
+- [PyMdown SmartSymbols](https://facelessuser.github.io/pymdown-extensions/extensions/smartsymbols/) — `(c)`, `(tm)`, `--`, `-->` are plain ASCII in source and not touched
+- [PyMdown MagicLink](https://facelessuser.github.io/pymdown-extensions/extensions/magiclink/) — `@username`, `#123` are plain text and pass through
+- [Material Grids](https://squidfunk.github.io/mkdocs-material/reference/grids/) — `<div class="grid cards" markdown>` is an HTML block; content is preserved but markdown inside is not reformatted
+- [Mermaid / Superfences](https://squidfunk.github.io/mkdocs-material/reference/diagrams/) — diagram code inside fenced blocks is never modified
+
+**Note on [PyMdown ProgressBar](https://facelessuser.github.io/pymdown-extensions/extensions/progressbar/)**: The syntax `[=50% "50%"]` resembles an undefined link reference and will be escaped to `\[=50% "50%"\]` by default. Use `--ignore-missing-references` to preserve it, or avoid this extension if you use mdformat without that flag.
+
 See the example test files, [./tests/pre-commit-test.md](https://raw.githubusercontent.com/KyleKing/mdformat-mkdocs/main/tests/pre-commit-test.md) and [./tests/format/fixtures.md](https://raw.githubusercontent.com/KyleKing/mdformat-mkdocs/main/tests/format/fixtures.md)
 
 ## `mdformat` Usage

{mdformat_mkdocs-5.2.0b0 → mdformat_mkdocs-5.2.0b2}/README.md

@@ -32,6 +32,23 @@ Supports:
 - [Python Markdown "Snippets"\*](https://facelessuser.github.io/pymdown-extensions/extensions/snippets)
     - \*Note: the markup (HTML) renders the plain text without implementing the snippet logic. I'm open to contributions if anyone needs full support for snippets
 
+### Features with Implicit Support
+
+The following MkDocs/Material/PyMdown syntax passes through mdformat-mkdocs unchanged — it is not modified or corrupted, but it is also not actively normalized:
+
+- [PyMdown Keys](https://facelessuser.github.io/pymdown-extensions/extensions/keys/) — `++ctrl+alt+del++` (not a markdown construct, preserved as-is)
+- [PyMdown Critic Markup](https://facelessuser.github.io/pymdown-extensions/extensions/critic/) — `{--deleted--}`, `{++added++}`, `{~~old~>new~~}`, `{==highlight==}`, `{>>comment<<}`
+- [PyMdown Highlight](https://facelessuser.github.io/pymdown-extensions/extensions/mark/) — `==marked text==`
+- [PyMdown Caret / Tilde](https://facelessuser.github.io/pymdown-extensions/extensions/caret/) — `H^2^O`, `CH~3~OH`
+- [PyMdown Emoji](https://facelessuser.github.io/pymdown-extensions/extensions/emoji/) — `:smile:`, `:material-icon:`
+- [PyMdown InlineHilite](https://facelessuser.github.io/pymdown-extensions/extensions/inlinehilite/) — language hints inside backtick spans (`:::python code`) are never modified
+- [PyMdown SmartSymbols](https://facelessuser.github.io/pymdown-extensions/extensions/smartsymbols/) — `(c)`, `(tm)`, `--`, `-->` are plain ASCII in source and not touched
+- [PyMdown MagicLink](https://facelessuser.github.io/pymdown-extensions/extensions/magiclink/) — `@username`, `#123` are plain text and pass through
+- [Material Grids](https://squidfunk.github.io/mkdocs-material/reference/grids/) — `<div class="grid cards" markdown>` is an HTML block; content is preserved but markdown inside is not reformatted
+- [Mermaid / Superfences](https://squidfunk.github.io/mkdocs-material/reference/diagrams/) — diagram code inside fenced blocks is never modified
+
+**Note on [PyMdown ProgressBar](https://facelessuser.github.io/pymdown-extensions/extensions/progressbar/)**: The syntax `[=50% "50%"]` resembles an undefined link reference and will be escaped to `\[=50% "50%"\]` by default. Use `--ignore-missing-references` to preserve it, or avoid this extension if you use mdformat without that flag.
+
 See the example test files, [./tests/pre-commit-test.md](https://raw.githubusercontent.com/KyleKing/mdformat-mkdocs/main/tests/pre-commit-test.md) and [./tests/format/fixtures.md](https://raw.githubusercontent.com/KyleKing/mdformat-mkdocs/main/tests/format/fixtures.md)
 
 ## `mdformat` Usage

{mdformat_mkdocs-5.2.0b0 → mdformat_mkdocs-5.2.0b2}/mdformat_mkdocs/__init__.py

@@ -1,7 +1,7 @@
 # ruff: noqa: RUF067
 """An mdformat plugin for `mkdocs`."""
 
-__version__ = "5.2.0b0"
+__version__ = "5.2.0b2"
 
 __plugin_name__ = "mkdocs"
 

{mdformat_mkdocs-5.2.0b0 → mdformat_mkdocs-5.2.0b2}/mdformat_mkdocs/plugin.py

@@ -194,27 +194,51 @@ def _render_inline_content(node: RenderTreeNode, context: RenderContext) -> str:
 
 
 _ESCAPED_LINK_SPACED_URL = re.compile(r"\\\[([^\]]*)\\\]\(([^)]*[ ][^)]*)\)")
+_PERCENT_ENCODED_URL_LINK = re.compile(r"\[([^\]]*)\]\(([^)]*%20[^)]*)\)")
+_ANGLE_BRACKET_SPACED_URL_SOURCE = re.compile(r"\]\(<([^>]* [^>]*)>\)")
 
 
 def _fix_links_with_spaced_urls(
     text: str,
-    node: RenderTreeNode,  # noqa: ARG001
+    node: RenderTreeNode,
     context: RenderContext,  # noqa: ARG001
 ) -> str:
-    """Rewrite escaped links with space-containing URLs to angle-bracket syntax.
+    r"""Rewrite links with space-containing URLs to angle-bracket syntax.
 
     CommonMark requires link destinations with spaces to use angle brackets.
-    When markdown-it fails to parse [text](url with space) as a link, mdformat
-    escapes the brackets. Detects and repairs those cases.
+    Handles two cases:
+
+    1. markdown-it fails to parse [text](url space) as a link and mdformat
+       escapes the brackets — detects ``\\[text\\](url space)`` and rewrites to
+       ``[text](<url space>)``.
+    2. markdown-it parses [text](<url space>) correctly but percent-encodes
+       the space in the href — detects [text](url%20space) and restores to
+       [text](<url space>) using the original source in node.content.
 
     Addresses: https://github.com/KyleKing/mdformat-mkdocs/issues/80
 
     """
-    return _ESCAPED_LINK_SPACED_URL.sub(
+    text = _ESCAPED_LINK_SPACED_URL.sub(
         lambda m: f"[{m.group(1)}](<{m.group(2)}>)",
         text,
     )
 
+    spaced_urls_from_source = {
+        m.group(1) for m in _ANGLE_BRACKET_SPACED_URL_SOURCE.finditer(node.content)
+    }
+    if spaced_urls_from_source:
+
+        def _restore_spaced_url(m: re.Match[str]) -> str:
+            link_text, encoded_url = m.group(1), m.group(2)
+            decoded_url = encoded_url.replace("%20", " ")
+            if decoded_url in spaced_urls_from_source:
+                return f"[{link_text}](<{decoded_url}>)"
+            return m.group(0)
+
+        text = _PERCENT_ENCODED_URL_LINK.sub(_restore_spaced_url, text)
+
+    return text
+
 
 def _render_text(node: RenderTreeNode, context: RenderContext) -> str:
     r"""Re-escape dollar signs that mdformat core stripped.

{mdformat_mkdocs-5.2.0b0 → mdformat_mkdocs-5.2.0b2}/pyproject.toml

@@ -25,7 +25,7 @@ license-files = ["LICENSE"]
 name = "mdformat_mkdocs"
 readme = "README.md"
 requires-python = ">=3.10.0"
-version = "5.2.0b0"
+version = "5.2.0b2"
 
 [project.entry-points."mdformat.parser_extension"]
 mkdocs = "mdformat_mkdocs"
@@ -56,6 +56,7 @@ recommended-mdsf = [
 ]
 test = [
   "beartype >= 0.21.0",
+  "hypothesis >= 6.100.0",
   "pytest >= 9.0.1",
   "pytest-beartype >= 0.2.0",
   "pytest-cov >= 7.0.0",
@@ -69,7 +70,7 @@ homepage = "https://github.com/kyleking/mdformat-mkdocs"
 
 [tool.commitizen]
 tag_format = "v${version}"
-version = "5.2.0b0"
+version = "5.2.0b2"
 version_files = ["mdformat_mkdocs/__init__.py", "pyproject.toml:^version"]
 
 [tool.mypy]
@@ -183,6 +184,13 @@ isolated_build = true
 requires = ["tox>=4.32.0"]
 skip_missing_interpreters = false
 
+[tool.tox.env.canary]
+basepython = ["py314"]
+changedir = "{tox_root}"
+commands = [["python", "scripts/canary.py", {default = [], extend = true, replace = "posargs"}]]
+description = "Run mdformat --check against real downstream repos. Optionally specify: '-- ruff uv' to test a subset."
+skip_install = false
+
 [tool.tox.env.cz]
 basepython = ["py314"]
 commands = [["cz", "bump", {default = [], extend = true, replace = "posargs"}]]