Skip to content

fix: render external Markdown links as standard anchors#214

Merged
pchuri merged 1 commit into
mainfrom
codex/fix-external-markdown-links
Jul 10, 2026
Merged

fix: render external Markdown links as standard anchors#214
pchuri merged 1 commit into
mainfrom
codex/fix-external-markdown-links

Conversation

@pchuri

@pchuri pchuri commented Jul 10, 2026

Copy link
Copy Markdown
Owner

Summary

  • render external Markdown links as standard <a href> anchors by default on Confluence Server/Data Center and in local conversions
  • centralize link-style validation and fallback selection to prevent the converter entry points from drifting
  • preserve Cloud smart-link behavior and keep explicit linkStyle: "wiki" output as a legacy compatibility option
  • update documentation for the new defaults and custom-domain Cloud behavior

Why

Confluence Data Center storage format represents external links with standard anchor elements. The previous Server/Data Center default emitted <ac:link><ri:url ... /></ac:link>, which can produce corrupted or unrenderable links. It could also generate malformed XML for quoted URL values and mishandle rich link bodies.

Compatibility

  • Cloud default remains smart.
  • Server/Data Center and local conversion defaults change from wiki to plain.
  • Users who explicitly configure linkStyle: "wiki" retain the existing legacy output.

Testing

  • npm test -- --runInBand — 777 tests passed
  • npm run lint
  • git diff --check
  • verified the issue reproduction through the local convert command

Fixes #213

@pchuri
pchuri merged commit 2fa54fb into main Jul 10, 2026
6 checks passed
@pchuri
pchuri deleted the codex/fix-external-markdown-links branch July 10, 2026 06:50
github-actions Bot pushed a commit that referenced this pull request Jul 10, 2026
## [2.16.1](v2.16.0...v2.16.1) (2026-07-10)

### Bug Fixes

* render external links as standard anchors ([#214](#214)) ([2fa54fb](2fa54fb))
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 2.16.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] External Markdown links converted to invalid <ac:link> instead of standard <a> tags

1 participant