Конвертор от Markdown към Confluence

Инженерните екипи, софтуерните архитекти и техническите писатели разчитат силно на Markdown за изготвяне на техническа документация. Въпреки това, корпоративните екипи често използват Atlassian Confluence като своя централна база от знания.

Защо конвертирането на Markdown към Confluence е предизвикателство

Confluence не изобразява естествено суров Markdown текст. Когато разработчиците поставят стандартен Markdown, общите елементи за форматиране се чупят:

• Кодовите блокове губят оцветяването на синтаксиса: Обикновените кодови ограждения се връщат към неформатиран текст.
• Таблиците се разпадат: Markdown таблиците не успяват да се изобразят като структурирани HTML таблици.
• Сигналните панели се чупят: Персонализираните цитати (> [!NOTE]) се сриват до основни цитати.

Рискът за сигурността на базираните на сървър конвертори

Много популярни онлайн инструменти обработват потребителски текст, като правят HTTP заявки към отдалечени сървъри. Utiliome решава тази уязвимост, като изпълнява целия двигател за превод локално във вашия уеб браузър. Не се изпращат API обаждания и никаква корпоративна интелектуална собственост не се излага на външни сървъри.

Разбиране на изходния формат

1. Confluence Storage Format (XHTML XML)

Използва се от Confluence Cloud. Utiliome картографира Markdown примитивите към точни XML възли, като <ac:structured-macro>.

2. Confluence Wiki Markup

Класическият текстов синтаксис, използван в Confluence Server и Data Center.

За да предостави готова за производство документация, Utiliome извършва високопрецизен Abstract Syntax Tree (AST) разбор.

1. Кодови ограждения и оцветяване

В стандартния Markdown:

```typescript
interface UserProfile {
  id: string;
}

Се трансформира в Atlassian Code Macro:
```xml
<ac:structured-macro ac:name="code" ac:schema-version="1">
  <ac:parameter ac:name="language">typescript</ac:parameter>
  <ac:plain-text-body><![CDATA[interface UserProfile {
  id: string;
}]]></ac:plain-text-body>
</ac:structured-macro>

2. GitHub Alert Callouts

Utiliome разпознава модели като > [!WARNING] и ги превежда в съответните макро панели за състояние в Confluence, като <ac:structured-macro ac:name="warning">.

3. Структурирани таблици за данни

Markdown таблиците се преобразуват в чисти XHTML таблици с пълно подравняване на заглавията.