Μετατροπέας Markdown σε Confluence

Οι ομάδες μηχανικής και οι τεχνικοί συγγραφείς βασίζονται σε μεγάλο βαθμό στο Markdown για τη σύνταξη τεχνικής τεκμηρίωσης. Ωστόσο, οι εταιρικές ομάδες χρησιμοποιούν συχνά το Atlassian Confluence ως την κεντρική τους βάση γνώσεων.

Γιατί η μετατροπή του Markdown σε Confluence είναι δύσκολη

Το Confluence δεν αποδίδει εγγενώς το ακατέργαστο κείμενο Markdown. Όταν οι προγραμματιστές επικολλούν τυπικό Markdown απευθείας στο Confluence, τα κοινά στοιχεία μορφοποίησης σπάνε:

• Τα μπλοκ κώδικα χάνουν την επισήμανση σύνταξης: Επιστρέφουν σε απλό κείμενο χωρίς μορφοποίηση.
• Οι πίνακες αποσυντίθενται: Δεν αποδίδονται ως δομημένοι πίνακες HTML.
• Τα πάνελ ειδοποιήσεων σπάνε: Τα προσαρμοσμένα blockquotes (> [!NOTE]) καταρρέουν.

Ο κίνδυνος ασφαλείας των μετατροπέων βάσει διακομιστή

Πολλά διαδικτυακά βοηθητικά προγράμματα επεξεργάζονται κείμενο κάνοντας αιτήματα HTTP σε απομακρισμένους διακομιστές. Το Utiliome λύνει αυτήν την ευπάθεια εκτελώντας ολόκληρη τη μηχανή μετατροπής τοπικά στο πρόγραμμα περιήγησή σας. Τα δεδομένα σας δεν φεύγουν ποτέ από τη συσκευή σας.

Μορφές εξόδου

1. Confluence Storage Format (XHTML XML)

Αυτή είναι η υποκείμενη μορφή για το Confluence Cloud. Το Utiliome αντιστοιχίζει το Markdown σε ακριβείς κόμβους XML του Confluence, όπως το <ac:structured-macro>.

2. Confluence Wiki Markup

Η κλασική σύνταξη κειμένου που χρησιμοποιείται στο Confluence Server.

Για να παραδώσει τεκμηρίωση έτοιμη για παραγωγή, το 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 & Confluence Panels

Το Utiliome αναγνωρίζει μοτίβα όπως > [!WARNING] και τα μεταφράζει στα κατάλληλα πάνελ μακροεντολών στο Confluence.

3. Δομημένοι πίνακες δεδομένων

Οι πίνακες Markdown αναλύονται σε καθαρούς πίνακες XHTML με πλήρη στοίχιση κεφαλίδων και διατήρηση της μορφοποίησης.