Ten konwerter Markdown do Jira przepisuje tekst na znaczniki wiki Jiry do opisów zgłoszeń i komentarzy: nagłówki, pogrubienia, bloki kodu z językiem, tabele, zagnieżdżone listy i linki. Wystarczy wkleić Markdown i skopiować gotowy tekst.
Ostatnia aktualizacja:
Jak to działa
Wklej opis
Opis błędu, treść pull requesta albo notatki ze sprintu wystarczy wkleić, otworzyć jako plik .md lub wczytać przykład („Wczytaj przykład”).
Sprawdź opcje
W „Alerty i uwagi” wybierasz panele lub cytaty, „{noformat} dla kodu bez języka” obsługuje bloki bez oznaczenia, a „Mapuj języki kodu” zamienia aliasy na nazwy znane Jirze.
Wklej w Jirze
Wynik trafia do pola, które korzysta z renderera wiki: w Jira Server i Data Center albo w trybie tekstowym starszych pól.
Funkcje
Składnia Jiry, nie HTML
*pogrubienie*, _kursywa_, -przekreślenie-, {{monospace}}, h1.–h6., bq., {quote} i [tekst|url] – dokładnie w postaci, której oczekuje renderer Jiry.
Makra kodu
```java staje się {code:java}, a kod bez języka może trafić do {noformat}. Aliasy takie jak py, sh czy yml są zamieniane na nazwy rozpoznawane przez Jirę.
Listy zagnieżdżone i mieszane
Punktory wewnątrz listy numerowanej są zapisywane jako #*, a głębsze poziomy jako ** i ##.
Ukośnik tylko tam, gdzie trzeba
Znaki, które uruchamiają efekty Jiry, np. * lub { }, są poprzedzane ukośnikiem wstecznym tylko w razie potrzeby, więc snake_case czy well-known pozostają czytelne.
Limity i prywatność
Pliki do 10 MB. Dane większe niż 256 KB są przetwarzane w wątku roboczym w tle (Web Worker), więc strona nie zamiera podczas konwersji. Nic nie jest wysyłane na serwer, a „Otwórz z adresu URL” pobiera plik bezpośrednio z podanego adresu. Szczegóły na stronie o prywatności.
Ograniczenia znaczników wiki w Jirze
Jira nie pozwala zacząć listy numerowanej od innej liczby niż 1, nie zna wyrównania kolumn w tabelach ani przypisów – w każdym z tych przypadków konwerter wyświetla ostrzeżenie. Listy zadań zamieniają się w znaki ☐ i ☑. Element listy nie może zawierać bloku kodu, dlatego blok ląduje bezpośrednio pod listą. Surowy HTML z Markdownu jest usuwany, bo Jira go nie renderuje.
Gdy trzeba pójść w drugą stronę, np. przenieść opis zgłoszenia do README, przyda się Jira → Markdown.
Najczęstsze pytania
Jak zamienić Markdown na format Jira?
Markdown wkleja się po lewej, a znaczniki wiki Jiry pojawiają się po prawej. Wystarczy kliknąć „Kopiuj” i wkleić tekst do zgłoszenia.
Czy Jira Cloud nadal obsługuje znaczniki wiki?
Nowy edytor Jira Cloud jest wizualny, ale w większości pól wciąż przekształca wpisane lub wklejone znaczniki wiki. Przyjmują je też reguły automatyzacji i REST API v2.
Dlaczego w Jirze akapity łamią się w połowie zdania?
W Jirze pojedynczy znak nowej linii to podział wiersza. Konwerter łączy zawinięte linie z Markdownu, więc akapity pozostają w jednym kawałku.
Co się dzieje z uwagami > [!NOTE] z GitHuba?
Stają się blokami {panel} z tytułem i pasującym kolorem tła albo, jeśli tak ustawisz w „Alerty i uwagi”, zwykłymi cytatami.
Czy opis błędu z kodem trafia na serwer?
Nie. Konwersja odbywa się w przeglądarce, więc wewnętrzne opisy zgłoszeń i fragmenty kodu nie opuszczają komputera.
Czy da się przenieść tekst z Jiry z powrotem do Markdownu?
Tak – służy do tego konwerter Jira → Markdown, do którego link znajduje się nad wynikiem.