Markdown Mode for Jira

Suport și documentație

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

Aplicația și Jira 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 Jira se instalează din Atlassian Marketplace de către un administrator al site-ului Jira:

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

După instalare, toți utilizatorii site-ului văd cele două acțiuni în meniul ••• (Actions) al tichetului. Nu e nimic de configurat. Administratorii pot dezactiva sau dezinstala aplicația din Settings → Apps → Manage apps. Dezinstalarea nu șterge nimic din tichete: tot ce ai salvat cu aplicația e conținut Jira obișnuit.

2. Primii pași

1. Deschide orice tichet Jira (în noua vizualizare).
2. Apasă ••• (Actions), în dreapta sus a tichetului.
3. Alege Edit in Markdown (descrierea) sau Comment in Markdown (comentariu nou sau editarea unuia de-al tău).
4. Scrie sau lipește Markdown. Previzualizarea arată exact ce va afișa Jira.
5. Apasă Save description sau Add comment, ori Cmd/Ctrl+Enter.

Butoane de aspect: Markdown (doar editorul), Split (împărțit) și Preview (previzualizare). Copy as Markdown copiază tot textul; în lista de comentarii, fiecare comentariu are propriul Copy as Markdown.

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 Jira 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 Jira?

Atlassian nu le permite aplicațiilor să înlocuiască sau să extindă editorul încorporat (vezi JRACLOUD-72631). Aplicația deschide un editor separat din meniul ••• al tichetului și scrie direct în câmpurile native de descriere și comentariu.

Au nevoie și ceilalți de aplicație ca să citească ce scriu?

Nu. Aplicația salvează conținut Jira obișnuit. Toată lumea vede formatarea Jira normală în tichet, în e-mailuri și în aplicațiile mobile.

Ce se întâmplă cu mențiunile, etichetele de status, panourile, datele și emoji-urile?

Apar ca etichete scurte, de exemplu :status[IN REVIEW]{color="blue"} sau :::panel{type="info"}, pe care le poți edita. Se salvează înapoi exact cum erau.

Dar atașamentele, imaginile, macrourile și aranjările în pagină?

Tot ce Markdown nu poate reprezenta se păstrează ca bloc protejat și se salvează înapoi neschimbat. Îl poți muta, dar nu-i poți edita interiorul.

Pot lipi text din ChatGPT, Claude sau GitHub?

Da. Sunt suportate CommonMark plus tabelele GitHub, listele de sarcini, textul tăiat și linkurile automate. Previzualizarea arată rezultatul exact din Jira înainte să salvezi.

Există o scurtătură de tastatură pentru deschidere?

Deocamdată Jira nu le permite aplicațiilor să înregistreze scurtături globale în vizualizarea tichetului. Pentru scurtăturile din editor, vezi scurtături de tastatură.

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

Nicăieri în afara Jira. Aplicația nu are server propriu: rulează în browserul tău, în Jira, și apelează API-ul Jira în numele tău. Noi (PPFTEC S.R.L.) nu primim niciodată conținutul tichetelor. Singurul lucru păstrat sunt două preferințe de afișare (aspectul și modul de tratare a rândurilor noi), în spațiul de stocare local al browserului. Vezi politica de confidențialitate (în engleză).

Ce permisiuni cere?

Citirea și scrierea elementelor de lucru Jira (read:jira-work, write:jira-work). Poate face doar ce poți face deja: dacă nu poți edita un tichet, editorul se deschide doar pentru citire.

Ce se întâmplă dacă două persoane editează aceeași descriere?

Înainte de salvare, aplicația verifică dacă descrierea s-a schimbat de când ai deschis-o și te lasă să reîncarci sau să suprascrii.

Cât costă?

Fiecare site Jira Cloud primește 30 de zile de probă gratuită prin Atlassian Marketplace. După aceea costă 0,60 USD per utilizator pe lună: site-urile cu cel mult 10 utilizatori plătesc o sumă fixă de 6 USD pe lună, iar prețul per utilizator scade peste 100 de utilizatori. Facturarea o face Atlassian; tabelul complet e în secțiunea de prețuri a listării din Marketplace.

6. Rezolvarea problemelor

„Read-only: your Jira permissions do not allow editing this issue”

Ai nevoie de permisiunea Jira de a edita tichetul (sau de a adăuga comentarii). Cere-o administratorului Jira.

„Someone changed this description after you opened it”

Alege Reload (lose my edits) (reîncarci și pierzi modificările) sau Overwrite (suprascrii).

„Markdown Mode for Jira needs an active subscription”

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

Acțiunile nu apar

Aplicația funcționează în noua vizualizare a tichetelor din Jira Cloud. Întreabă administratorul dacă aplicația e instalată și activată.

7. Limitări cunoscute

• Doar Jira Cloud, în noua vizualizare a tichetelor. Jira Data Center și Server nu sunt suportate.
• Testată pe spații Jira Software de tip team-managed. Spațiile company-managed și Jira Service Management nu au fost încă testate.
• Aplicația nu poate adăuga un mod Markdown în editorul propriu al Jira și nici o scurtătură globală pentru deschiderea editorului. Se deschide din meniul ••• al tichetului.
• Comment in Markdown editează doar comentariile tale.
• Etichetele pentru elementele specifice Jira (de exemplu :status[…]) nu sunt Markdown standard. Alte instrumente Markdown le afișează ca text simplu.
• Atașamentele, macrourile și aranjările în pagină se păstrează ca blocuri protejate: în Markdown pot fi mutate, 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 tichete cu date personale, decât dacă e necesar pentru a reproduce o problemă.

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