Convert Engineering RFCs to Confluence Wiki Markup

Motivation section with a rationale quote

The heading becomes h2. and the blockquote rationale becomes bq. Upgrade to a {info} panel in Confluence if you want a styled callout.

Markdown in:
## Motivation
> The current retry logic causes thundering-herd outages.
We need bounded, jittered backoff.

Wiki out:
h2. Motivation
bq. The current retry logic causes thundering-herd outages.
We need bounded, jittered backoff.

Code sample with a language tag

Fenced Go becomes a {code:go} macro. The pointer star and the brackets in the slice index are preserved because the block is stashed before inline rules run.

Markdown in:
```go
func retry(p *RetryPolicy) {
  delays := []int{1, 2, 4}
}
```

Wiki out:
{code:go}
func retry(p *RetryPolicy) {
  delays := []int{1, 2, 4}
}
{code}

Mermaid diagram becomes a code macro, not a picture

A mermaid fence converts to {code:mermaid}. Confluence needs the Mermaid app to render it; otherwise pre-render to an image and embed.

Markdown in:
```mermaid
graph TD; A-->B; B-->C;
```

Wiki out:
{code:mermaid}
graph TD; A-->B; B-->C;
{code}

Confluence: install the Mermaid app, or replace with !diagram.png!

Alternatives Considered as a list with references

Bullet alternatives become * items and the ADR reference link flips to pipe form.

Markdown in:
## Alternatives Considered
- Fixed backoff (rejected, see [ADR-7](https://wiki/adr7))
- No retry (rejected, breaks idempotency)

Wiki out:
h2. Alternatives Considered
* Fixed backoff (rejected, see [ADR-7|https://wiki/adr7])
* No retry (rejected, breaks idempotency)

Decision matrix left for manual rebuild

A GFM decision matrix passes through untouched. Rebuild it as Confluence wiki table rows so it renders as a grid.

Markdown in:
| Option | Latency | Risk |
| ------ | ------- | ---- |
| Jittered backoff | low | low |
| Fixed backoff | low | high |

Wiki out (unchanged):
| Option | Latency | Risk |
| ------ | ------- | ---- |
| Jittered backoff | low | low |
| Fixed backoff | low | high |

Confluence form:
||Option||Latency||Risk||
|Jittered backoff|low|low|
|Fixed backoff|low|high|

The transform has no table logic, so a decision matrix or comparison table passes through as plain pipe text and renders as monospaced lines in Confluence. Rebuild it as ||Option||Pros||Cons|| rows. This corrects earlier copy implying decision matrices keep their layout automatically.

A ``` mermaid fence converts to a {code:mermaid}…{code} block — the diagram source, not a rendered image. Confluence renders it only with a Mermaid app installed; otherwise pre-render the diagram to PNG/SVG and embed it as an attachment with !diagram.png!`.

![architecture](url) becomes ![architecture|url], which Confluence will not render inline. Attach the image to the page and reference it with !architecture.png!, or paste it into the editor directly.

There is no math support — $E=mc^2$ or \[ … \] stays as literal text. Use a Confluence LaTeX/math macro after pasting for properly typeset equations. To normalize math delimiters on the Markdown side first, see md-math-normalizer.

An identifier like max_in_flight written in prose can render as italic in Confluence (_ means italic). Wrap such names in inline code so they become {{max_in_flight}} monospace and the underscores are safe.

Markdown footnotes [^1] and their definitions are not handled and remain as literal text. Inline the note where it is referenced, or use a Confluence footnote macro after pasting.

Pasting wiki markup straight into the Confluence body shows literal h2. and {code} text. Use Insert > Markup > Wiki Markup so Confluence interprets the syntax before inserting.

No input returns an empty string. Paste the RFC or select a file first.

A long RFC with embedded code listings can pass 500,000 characters while under 1 MB. Convert section by section, or upgrade to Pro (5,000,000 characters). Merge parts into one page first with md-merger if needed.