Markdig-Renderer¶

ConfluenceSynkMD verwendet Markdig als Markdown-Parser und erweitert ihn mit benutzerdefinierten Renderern, die Confluence Storage Format (XHTML) statt Standard-HTML erzeugen.

Funktionsweise¶

Der ConfluenceRenderer registriert individuelle Renderer für jeden Markdown-Elementtyp:

graph TD
    A[Markdown AST] --> B[ConfluenceRenderer]
    B --> C[HeadingRenderer]
    B --> D[CodeBlockRenderer]
    B --> E[LinkInlineRenderer]
    B --> F[ListRenderer]
    B --> G[TableRenderer]
    B --> H[... 13+ weitere]

Verfügbare Renderer¶

Renderer	Verarbeitet	Confluence-Output
`HeadingRenderer`	`#` Überschriften	`<h1>`–`<h6>` mit optionalen Ankern
`CodeBlockRenderer`	Fenced Code Blocks	`<ac:structured-macro ac:name="code">`
`LinkInlineRenderer`	`[Text](URL)` Links	`<ac:link>` oder Web-UI-URLs
`TableRenderer`	Markdown-Tabellen	`<table>` mit Layout-Optionen
`QuoteBlockRenderer`	Blockquotes / Alerts	Info/Note/Warning-Makros
`EmphasisInlineRenderer`	`kursiv` / `fett`	`<em>` / `<strong>`

Neuen Renderer hinzufügen¶

Renderer-Klasse in src/ConfluenceSynkMD/Markdig/Renderers/ erstellen
In ConfluenceRenderer.cs registrieren
Tests hinzufügen

GitHub Alerts → Confluence-Makros¶

Markdown	Confluence-Makro
`> [!NOTE]`	`<ac:structured-macro ac:name="info">`
`> [!WARNING]`	`<ac:structured-macro ac:name="warning">`
`> [!TIP]`	`<ac:structured-macro ac:name="tip">`
`> [!IMPORTANT]`	`<ac:structured-macro ac:name="note">`
`> [!CAUTION]`	`<ac:structured-macro ac:name="warning">`

Verwenden Sie --use-panel, um alle Alerts als Panel-Makros darzustellen.