Ten konwerter zamienia Markdown na Confluence w jednej z dwóch postaci: znaczniki wiki do okna „Wstaw znaczniki” albo format przechowywania (XHTML) dla REST API. Wystarczy wkleić tekst lub otworzyć plik .md i skopiować wynik.
Ostatnia aktualizacja:
Jak to działa
Wklej dokument
README, instrukcję wdrożenia czy notatkę ze spotkania można wkleić, otworzyć jako plik .md, wczytać z adresu URL albo zacząć od przykładu.
Wybierz format wyniku
W polu „Format wyniku” do wyboru są „Znaczniki wiki” dla edytora i „Format przechowywania (XHTML)” dla API. Obok ustawia się zapis uwag („Alerty i uwagi”) oraz mapowanie języków kodu.
Przenieś do Confluence
W edytorze wybierz + → Markup, ustaw Confluence wiki, wklej tekst i zatwierdź. Przy publikacji przez API XML trafia do treści strony.
Funkcje
Dwa formaty wyniku
Znaczniki wiki (h2., {code}, ||tabele||) albo format przechowywania z elementami ac:structured-macro dla kodu, paneli informacyjnych i list zadań.
Uwagi jako makra
Alerty GitHub, np. > [!NOTE] czy > [!WARNING], stają się makrami {info}, {tip}, {note} i {warning}, a nie zwykłymi cytatami.
Kod z językiem i tytułem
Blok kodu zachowuje język (zamieniony na nazwę, którą Confluence podświetla) oraz tytuł podany jako title="…" w wierszu otwierającym blok.
Uczciwe ostrzeżenia
Pod wynikiem wymienione jest wszystko, czego Confluence nie potrafi wyrazić, np. przypisy albo wyrównanie kolumn w znacznikach wiki.
Limity i prywatność
Pliki do 10 MB. Teksty większe niż 256 KB są konwertowane w wątku roboczym w tle (Web Worker), dzięki czemu strona cały czas reaguje. Nic nie jest wysyłane na serwer: konwersja odbywa się w przeglądarce, a „Otwórz z adresu URL” pobiera plik bezpośrednio z podanego adresu. Więcej na stronie o prywatności.
Co zmienia się po drodze do Confluence
W znacznikach wiki pojedynczy znak nowej linii w akapicie oznacza wymuszony podział wiersza, dlatego zawinięte linie z Markdownu są łączone spacją. Element listy nie może zawierać bloku kodu ani drugiego akapitu – taki blok trafia tuż za listę, a pod wynikiem pojawia się ostrzeżenie. Przypisy stają się liczbami w indeksie górnym z treścią na końcu strony, bo Confluence nie ma makra przypisów.
Obrazy zachowują adres URL, ale załączniki trzeba osobno dodać do strony. Wzory zostają jako TeX o stałej szerokości znaków, chyba że w Confluence zainstalowano aplikację obsługującą LaTeX. Konwersję w odwrotnym kierunku wykonuje Confluence → Markdown.
Najczęstsze pytania
Jak wkleić Markdown do Confluence, żeby nie stracić formatowania?
Najpierw przekonwertuj tekst tutaj, a potem w edytorze Confluence otwórz okno Insert markup („Wstaw znaczniki”), zaznacz Confluence wiki, wklej znaczniki i zatwierdź.
Czy Confluence Cloud obsługuje Markdown?
Tylko częściowo: edytor w chmurze zamienia część składni podczas pisania, ale wklejony dokument traci tabele, języki kodu i panele. Znaczniki wiki wstawione przez okno znaczników je zachowują.
Czym jest format przechowywania w Confluence?
To oparty na XHTML format, w którym Confluence zapisuje strony. Przydaje się przy REST API i narzędziach, które publikują dokumentację prosto z repozytorium Git.
Czy listy zadań (checkboxy) przechodzą do Confluence?
W formacie przechowywania stają się prawdziwymi zadaniami Confluence. Znaczniki wiki nie mają składni zadań, więc pojawiają się znaki ☐ i ☑.
Jak dodać spis treści na stronie?
Wystarczy włączyć opcję „Spis treści” – na początku strony pojawi się makro {toc}.
Czy dokument jest wysyłany na serwer?
Nie. Konwersja z Markdownu do Confluence działa w całości w przeglądarce, więc wewnętrzna dokumentacja nie opuszcza komputera.