feat: raw Confluence passthrough via confluence-tagged fenced block

[pilat]

Why

Some Confluence constructs have no Markdown equivalent — a clickable Table of Contents, status lozenges, Page Properties (details), expand/panel/column macros, and so on. Today there is no way to express them: pasting raw <ac:...> storage XML into prose doesn't work, because Markdown parses it as a text node (CommonMark forbids : in HTML tag names) and the text converter then runs it through escapeXml, so it renders as the literal visible string <ac:structured-macro…>.

This adds a single, generic escape hatch instead of a one-off converter per macro.

What

A fenced code block tagged confluence is emitted verbatim into the page's storage format — not escaped, not wrapped in a code macro:

```confluence
<ac:structured-macro ac:name="toc">
  <ac:parameter ac:name="minLevel">2</ac:parameter>
  <ac:parameter ac:name="maxLevel">2</ac:parameter>
</ac:structured-macro>
```

The implementation is one branch in the code-block converter, placed after the existing mermaid branch (which already emits raw storage XML) and before the generic code-macro path. Fence content is stored byte-for-byte in the node's value, so returning it as-is preserves <, &, ", newlines and indentation.

Notes

• Exact match on the language identifier — confluence only, no case-folding, no trimming. An uppercase Confluence (or any other tag) falls through to a normal code block. There's a regression test pinning this.
• Block-level only. The whole fenced block is raw storage XML; there is no inline passthrough into the middle of a paragraph or a GFM table cell.
• No validation. The XML is emitted as-is; Confluence rejects malformed storage format at publish time, not here.
• Existing mermaid and real-language code blocks (js, yaml, …) are unchanged.
• README gains a short "Raw Confluence Passthrough" section documenting the feature.

[coderabbitai]

Warning

Review limit reached

@pilat, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 35 minutes and 44 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ba9327fa-dfd4-4c39-96ed-5d371643e491

📥 Commits

Reviewing files that changed from the base of the PR and between 5270305 and 83af62b.

📒 Files selected for processing (3)

• README.md
• src/elements/code.ts
• test/converter.test.ts

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/confluence-passthrough

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}