Markdown Mode for Confluence

Suport și documentație

Cum instalezi și folosești Markdown Mode for Confluence, răspunsuri la întrebări frecvente, limitări cunoscute și cum ne contactezi.

Aplicația și Confluence folosesc aici denumirile din interfața în engleză (de exemplu Edit in Markdown). Le-am păstrat așa ca să le găsești exact pe ecran.

1. Instalare

Markdown Mode for Confluence se instalează din Atlassian Marketplace de către un administrator al site-ului Confluence:

1. În Confluence Cloud, deschide Settings (rotița) → Apps → Explore more apps.
2. Caută Markdown Mode for Confluence și alege Get app.
3. Verifică permisiunile cerute (read:page:confluence, write:page:confluence) și confirmă.

După instalare, toți utilizatorii site-ului văd cele două acțiuni în meniul ••• → Apps al paginii. Nu e nimic de configurat. Dezinstalarea nu șterge nimic din pagini: tot ce ai publicat cu aplicația e conținut Confluence obișnuit.

2. Primii pași

1. Deschide o pagină sau un articol de blog din Confluence (în modul de vizualizare, nu în editor).
2. Apasă ••• (More actions), în dreapta sus a paginii, apoi Apps.
3. Alege Edit in Markdown sau New child page from Markdown.
4. Scrie sau lipește Markdown. Previzualizarea arată ce va publica Confluence.
5. Apasă Publish sau Create page, ori Cmd/Ctrl+Enter.

Butoane de aspect: Markdown (doar editorul), Split (împărțit) și Preview (previzualizare). Copy as Markdown copiază toată pagina.

Pagină copil nouă: scrie un titlu sau lasă titlul gol și începe textul cu # Titlu. Primul titlu devine titlul paginii și nu se mai repetă în conținut.

Dacă browserul blochează copierea, se deschide o casetă cu textul deja selectat: apasă Cmd+C (Mac) sau Ctrl+C (Windows, Linux).

3. Scurtături de tastatură (în editor)

4. Referință Markdown

Aplicația suportă CommonMark standard, plus tabelele GitHub, listele de sarcini (- [ ]), textul tăiat (~~) și linkurile automate. Elementele specifice Confluence se scriu ca etichete scurte:

Implicit, un singur rând nou în interiorul unui paragraf devine spațiu (regula CommonMark). Bifează Single line breaks are kept (GitHub style) ca să rămână rânduri noi.

5. Întrebări frecvente

De ce nu un comutator Markdown chiar în editorul Confluence?

Atlassian nu le permite aplicațiilor să înlocuiască editorul încorporat (vezi CONFCLOUD-68272). Aplicația deschide un editor separat din meniul ••• → Apps al paginii și publică direct în pagină.

Au nevoie cititorii de aplicație?

Nu. Aplicația publică conținut Confluence obișnuit. Toată lumea vede o pagină normală, în căutare, în notificări și în aplicațiile mobile.

Se creează o versiune nouă a paginii?

Da. Fiecare publicare e o versiune normală, cu mesajul „Edited in Markdown Mode”. Istoricul, compararea și restaurarea versiunilor funcționează ca de obicei.

Ce se întâmplă cu macrourile, imaginile și atașamentele?

Se păstrează ca blocuri protejate și se publică înapoi exact cum erau. Macrourile le editezi în editorul Confluence.

Ce se întâmplă dacă altcineva editează pagina?

Înainte de publicare, aplicația verifică dacă a fost publicată o versiune mai nouă de când ai deschis-o și te lasă să reîncarci sau să publici oricum. Dacă editorul Confluence are modificări nepublicate, aplicația te avertizează întâi: Confluence combină versiunea nouă cu acea ciornă și o poate suprascrie dacă diferă mult.

Unde îmi sunt stocate datele? Vedeți paginile mele?

Nicăieri în afara Confluence. Aplicația nu are server propriu: rulează în browserul tău, în Confluence, și apelează API-ul Confluence în numele tău. Noi (PPFTEC S.R.L.) nu primim niciodată conținutul paginilor. Vezi politica de confidențialitate (în engleză).

Ce permisiuni cere?

read:page:confluence și write:page:confluence. Poate face doar ce poți face deja: dacă nu poți edita o pagină, editorul se deschide doar pentru citire.

Cât costă?

Fiecare site Confluence Cloud primește 30 de zile de probă gratuită prin Atlassian Marketplace. După aceea costă 5 USD pe lună pentru site-urile cu cel mult 10 utilizatori și 0,50 USD per utilizator pe lună între 11 și 100 de utilizatori, cu prețuri per utilizator mai mici peste 100. Facturarea o face Atlassian; tabelul complet e în secțiunea de prețuri a listării din Marketplace.

6. Rezolvarea problemelor

„Read-only: your Confluence permissions do not allow editing this page”

Ai nevoie de permisiunea de editare pe pagină și în spațiu. Cere-o administratorului spațiului.

„Someone published a new version of this page after you opened it”

Alege Reload (lose my edits) (reîncarci și pierzi modificările) sau Publish anyway (publici oricum).

„This page has unpublished changes in the Confluence editor”

Cineva are modificări deschise în editorul Confluence. Publică-le sau renunță la ele acolo, apoi publică din Markdown Mode.

„Markdown Mode for Confluence needs an active subscription”

Abonamentul site-ului a expirat. Un administrator Confluence îl poate reînnoi din Settings → Apps → Manage apps.

Acțiunile nu apar

Acțiunile sunt în submeniul Apps din meniul ••• al paginii, în modul de vizualizare. Întreabă administratorul dacă aplicația e instalată.

7. Limitări cunoscute

• Doar Confluence Cloud. Confluence Data Center și Server nu sunt suportate.
• Documentele live, ciornele și paginile arhivate se deschid doar pentru citire în această versiune (le poți copia ca Markdown).
• Comentariile paginilor nu pot fi încă editate în Markdown.
• Aplicația nu poate adăuga un mod Markdown în editorul propriu al Confluence. Se deschide din meniul ••• → Apps al paginii.
• Etichetele pentru elementele specifice Confluence (de exemplu :status[…]) nu sunt Markdown standard. Alte instrumente Markdown le afișează ca text simplu.
• Macrourile, atașamentele și deciziile se păstrează ca blocuri protejate: în Markdown pot fi mutate sau șterse, dar nu editate.
• Prima deschidere a editorului poate dura câteva secunde.

8. Contact

• E-mail: support@ppftec.com
• Oferim suport prin e-mail în zilele lucrătoare, în limita posibilităților.
• Raportări de securitate: support@ppftec.com (vezi security.txt)
• Politica de confidențialitate · Termeni (în engleză)

Te rugăm să nu trimiți conținut din pagini cu date personale, decât dacă e necesar pentru a reproduce o problemă.

Furnizată de PPFTEC S.R.L., România.