v0.10.1 - GitHub Heading IDs, Codeblock Parsing & Link Fixes
v0.10.1 - GitHub Heading IDs, Codeblock Parsing & Link Fixes
GitHub Heading IDs, Codeblock Parsing & Link Fixes
v0.10.1 adds support for GitHub-compatible flat heading IDs, alongside fixes for codeblock preservation in MDX compilation, internal link normalization for filenames containing dots and query parameters, and sidebar parsing improvements in the MkDocs migration tool.
Added
- GitHub-Compatible Flat Heading IDs (
@docmd/parser): Added option"markdown": { "headingIds": "github" }(or per-page frontmatterheadingIds: github) to generate flat heading IDs following GitHub’s slugging convention (lowercase, drop punctuation without collapsing dashes, spaces to hyphens, and-1,-2suffixes for duplicate headings on a page). By default, docmd preserves its existing hierarchical contextual heading IDs ("nested"). Suggested by @thinkbig1979 in #286.
Fixed
- Codeblock Expression Stripping (
@docmd/plugin-mdx,lite-mdx): Upgradedlite-mdxto0.1.2with robust CommonMark-compliant code fence scanning. Code blocks containing quotes, titles, or language attributes (such as```json "docmd.config.json") are now strictly protected from JSX/MDX expression compilation. Additionally,@docmd/plugin-mdxnow only triggers MDX processing on.mdfiles when JSX syntax or imports/exports are present. - Internal Links with Dots & Query Strings (
@docmd/parser): Fixed issue where links to Markdown pages with dots in their filename (e.g.release-1.0.md,docmd.config.md) were misclassified as raw file assets, skipping trailing slashes and subpage../depth shifts. Query strings (e.g.other.md?tab=npm,index.md?tab=npm) are now separated alongside hash fragments before extension stripping and properly preserved across relative depth shifts. Resolves #284. - MkDocs Navigation Migration (
@docmd/core): Fixeddocmd migrate --mkdocsto terminate navigation parsing at the next top-level YAML key (preventingplugins:andmarkdown_extensions:from being added to the sidebar), unquote quoted titles/paths, and mapindex.mdto root/or subfolder<dir>/routes. Contributed by @jayhemnani9910 in #285. - Dynamic Version Test Assertion: Updated test assertion in
tests/cli-contracts/variables-engine.test.jsto assert dynamically againstregistry.get('docmd.version'), preventing breakage during patch bumps.
Documentation & Diagnostics
- Heading IDs & Link Normalization Guides: Added configuration and frontmatter reference documentation for
markdown.headingIds, and documented link preservation for filenames containing dots and query parameters across all four locales. - Iconify Plugin Documentation: Added dedicated documentation and live interactive container examples (Callouts, Buttons, Cards, Tabs, Tags) across all four locales (
en,de,es,zh) inplugins/iconify.md. - Nested Code Block Formatting: Fixed nested code fence escaping in the Tabs component example, using 4-backtick blocks with wrapping
::: tabscontainer syntax.
Links
Documentation: https://docs.docmd.io/
Cloud Platform: https://cloud.docmd.io/
Dev & Writing Skills: https://github.com/docmd-io/docmd-skills
New Contributors
- @jayhemnani9910 made their first contribution in https://github.com/docmd-io/docmd/pull/285
Full Changelog: https://github.com/docmd-io/docmd/compare/0.10.0...0.10.1