feat: button-link navigation — href on buttons, nav links, multi-page routing

[teezeit]

Tracking PR to upstream: akonan#79

Summary

wiremd now supports interactive multi-page navigation in the dev server.

17.04.2026_18.46.53_REC_trimmed.mp4

Write a shared navbar with page links, run wiremd home.md --serve 3001, and clicking a button navigates to and renders the target .md file — no build step between pages.

wiremd examples/gallery/multi-page/home.md --serve 3001
# Click [About] → renders about.md live
# Click [Contact] → renders contact.md live

[[ :logo: MyApp | *Home* | [About](./about.md) | [Contact](./contact.md)* ]]

See examples/gallery/multi-page/ for a working three-page prototype.

---

What enables this

Dev server routes any .md on demand

GET / redirects to the entry file. GET /page.md renders that file on demand via the existing renderFile callback — no pre-build required.

Nav [[ ]] items now support real hrefs (bug fix)

[text](url) inside [[ ]] previously dropped the URL silently. Root cause: the inline-containers plugin used c.value || '' which returns empty string for MDAST link nodes. Fixed with a serializeChild function that reconstructs [text](url) from the link node before pipe-splitting.

*text* active state in nav (bug fix)

*Home* inside [[ ]] previously rendered as the literal string *Home*. Fixed: detected as the active/current-page item, asterisks stripped, .active class added (all 6 themes).

[text](url)* primary CTA in nav

Nav items with * suffix render with primary button styling, consistent with [Button]* elsewhere.

Multiple [[Btn](url)] on one line (bug fix)

[[Get Started](url)]* [[See Features](url)] previously broke after the first button — the second URL was dropped and brackets showed as literal text. Root cause: the 3-child button-link detection only handled a single button. For two buttons on one line, remark produces 5 children ([, link, ]* [, link, ]). Replaced the 3-child check with tryParseButtonLinkSequence which handles n ≥ 1.

Button href on standalone buttons

[[Go to Docs](./docs.md)]     → <a href="..." class="wmd-button">
[[Get Started](url)]*         → primary button-link
[Button]{href:./page.md}      → attribute form

Disambiguation

[Text](url)       → plain link
[Text]            → non-navigating button
[[Text](url)]     → button that navigates

Inside [[ ]] nav:

Text              → nav item (href="#")
*Text*            → active/current page
[Text](url)       → nav item with real href
[Text](url)*      → primary CTA

Test plan

• Nav [text](url) → href preserved
• *Home* in nav → no literal asterisks, active styling
• [[Btn1](url)]* [[Btn2](url)] on one line → two buttons, no literal brackets
• Dev server: GET / redirects to entry file
• Dev server: GET /page.md renders on demand
• 501 tests passing
• examples/gallery/multi-page/ — navigable three-page prototype

🤖 Generated with Claude Code