Darmowy konwerter online AD do MD

Markdown jest powszechnie wymagany w plikach README, repozytoriach Git, witrynach z dokumentacją i lekkiej edycji, podczas gdy niektóre dokumenty źródłowe są dostarczane jako pliki AsciiDoc z krótszym rozszerzeniem .ad. Konwersja źródła zachowuje jego czytelną treść, jednocześnie dostosowując nagłówki, listy, odnośniki, bloki kodu i tabele do składni Markdown.

Czym jest format AD

W kategorii plików tekstowych rozszerzenie .ad zwykle oznacza plik źródłowy AsciiDoc. AsciiDoc to język znaczników w postaci zwykłego tekstu przeznaczony do dokumentacji technicznej, książek, instrukcji, plików README i stron internetowych; ten sam język jest częściej zapisywany z rozszerzeniem .adoc lub .asciidoc.

Pliki AsciiDoc można tworzyć za pomocą oryginalnego procesora AsciiDoc, Asciidoctor, edytorów tekstu i systemów budowania dokumentacji. Zawierają one czytelne znaczniki źródłowe, takie jak tytuły sekcji, listy, odnośniki, bloki kodu źródłowego, admonitions, tabele, atrybuty i dyrektywy include. Samo rozszerzenie nie jest rozstrzygające, dlatego przed konwersją należy potwierdzić, że plik zawiera składnię AsciiDoc.

Czym jest format MD

.md oznacza plik Markdown. Markdown używa znaków zwykłego tekstu do oznaczania nagłówków, wyróżnień, odnośników, list, cytatów, bloków kodu i innej struktury dokumentu. GitHub, GitLab, generatory witryn statycznych, aplikacje do robienia notatek, platformy dokumentacji i edytory kodu często renderują Markdown.

Markdown jest przydatny, gdy dokument musi pozostać łatwy do odczytania bez renderera, dobrze współpracować z systemem kontroli wersji lub być akceptowany jako plik README albo źródło dokumentacji. GitHub Flavored Markdown, powszechnie nazywany GFM, dodaje tabele, listy zadań, przekreślenia i bloki kodu z ogrodzeniami.

Jak faktycznie przekonwertować AD do MD

Korzystanie z Asciidoctor i Pandoc

Aby przeprowadzić niezawodną konwersję, użyj Asciidoctor do zinterpretowania źródła AsciiDoc i wygenerowania DocBook XML, a następnie użyj Pandoc do przekonwertowania tego ustrukturyzowanego pliku pośredniego do Markdown GFM. Zainstaluj Asciidoctor i Pandoc, umieść źródło w katalogu roboczym i uruchom:

1. Przekonwertuj plik AsciiDoc do DocBook XML:
   asciidoctor -b docbook5 -o input.xml input.ad
2. Przekonwertuj XML do Markdown:
   pandoc -f docbook -t gfm input.xml -o output.md
3. Otwórz output.md w edytorze Markdown i sprawdź nagłówki, odnośniki, tabele, obrazy, listy i bloki kodu.

Aby użyć jednokrokowego potoku shell, uruchom:

asciidoctor -b docbook5 -o - input.ad | pandoc -f docbook -t gfm -o output.md

Korzystanie z wbudowanego konwertera online

Możesz bezpłatnie przekonwertować plik w serwisie 101convert.com bez instalowania oprogramowania: wybierz format wejściowy AD, prześlij plik input.ad, wybierz MD jako format wyjściowy, rozpocznij konwersję i pobierz wynikowy plik .md.

Ograniczenia jakości i zgodności

Konwersja zmienia znaczniki, a nie tylko zmienia nazwę rozszerzenia. Atrybuty AsciiDoc, treści warunkowe, makra, odwołania krzyżowe, osadzone diagramy oraz złożone struktury tabel lub admonitions mogą wymagać ręcznej edycji po konwersji.

Używaj ścieżek, które pozostaną prawidłowe z lokalizacji pliku Markdown. Odwołania do obrazów mogą wymagać poprawienia, a role lub atrybuty specyficzne dla AsciiDoc mogą zostać pominięte, ponieważ standardowy Markdown nie ma ich odpowiedników. Wynik GFM jest zwykle najbardziej zgodnym celem dla GitHub i GitLab, natomiast podstawowy Markdown jest preferowany, gdy miejsce docelowe obsługuje tylko oryginalną składnię.

Dyrektywy include AsciiDoc i podstawienia źródłowe mogą wpływać na wygenerowany wynik. Przejrzyj dane wyjściowe po wstępnym przetworzeniu, szczególnie gdy źródło korzysta z plików zewnętrznych, niestandardowych atrybutów lub względnych ścieżek obrazów.