Repository navigation
v0.3.20 - Align Markdown tables indented inside MkDocs tabs and admonitions (#896)
🌟 Summary
v0.3.20 improves Markdown table formatting inside MkDocs tabs and admonitions, while making the CLA workflow safer and more precise.
📊 Key Changes
-
📝 Improved nested Markdown tables
- Tables inside MkDocs admonitions such as
!!! noteand tabs such as=== "Tab"are now detected and aligned correctly. - Formatting supports CJK characters and common emoji using standard-library Unicode width information.
- Existing fenced code blocks and ordinary indented code remain unchanged.
- Reference documentation under
docs/**/reference/**remains excluded from table formatting. - Added focused tests covering nested tables, tabs, escaped pipe characters, Unicode text, and fenced code.
- Tables inside MkDocs admonitions such as
-
⚙️ More reliable Markdown processing
- MkDocs containers and fenced code blocks are tracked during a single forward scan.
- No new dependencies, installation steps, filesystem traversal, or file-reading behavior were introduced.
- The formatter was validated against 25 existing table files and all 324 current non-reference documentation files.
-
🔐 Safer CLA recheck handling
- The CLA workflow now recognizes
recheckonly when the entire comment is exactlyrecheck. - CLA signature comments continue to support substring matching.
- The workflow example in
cla/README.mdwas updated to match.
- The CLA workflow now recognizes
-
📦 Version update
- Bumped the package version from
0.3.19to0.3.20.
- Bumped the package version from
🎯 Purpose & Impact
- ✅ Documentation tables in MkDocs tabs and admonitions will be consistently readable and aligned.
- 🛡️ Code examples are protected from accidental formatting changes, reducing the risk of altering executable snippets.
- 🌏 Tables containing Chinese, Japanese, Korean, or emoji content should display with more accurate column spacing.
- 🔁 Markdown formatting remains stable and idempotent, meaning repeatedly running the formatter should not create further changes.
- 🚦 CLA automation is less likely to trigger unexpectedly from unrelated comments containing the word “recheck.”
- 🚫 No model architecture, training, inference, or deployment features changed in this release.
What's Changed
- Keep CLA recheck comments exact by @glenn-jocher in #895
- Align Markdown tables indented inside MkDocs tabs and admonitions by @Laughing-q in #896
New Contributors
- @Laughing-q made their first contribution in #896
Full Changelog: v0.3.19...v0.3.20