Przejdź do treści
100% lokalnie

Konwerter AsciiDoc do Markdown

Konwertuj składnię AsciiDoc na Markdown i z powrotem bezpośrednio w przeglądarce.

Wejście
Wynik

Konwerter AsciiDoc do Markdown

Wklej AsciiDoc — plik README, stronę dokumentacji lub fragment wyeksportowany z wiki — a to narzędzie przepisuje go na Markdown. Nagłówki (=, ==, aż ======) stają się # aż ######. Tekst pogrubiony (*słowo*) zmienia się na **słowo**, kursywa (_słowo_) i kod wstawiony (`słowo`) mają już tę samą składnię w obu formatach i przechodzą bez zmian. link:url[tekst] zmienia się na [tekst](url), image::url[alt] na ![alt](url), blok [source,język] w ---- zmienia się na blok kodu w ogrodzeniu i tabelę |=== zmienia się na tabelę Markdown z wierszem separatora. Ostrzeżenia NOTE, TIP, WARNING, IMPORTANT i CAUTION stają się cytatami blokowymi lub ostrzeżeniami w stylu GitHub i wszystko działa również w odwrotnym kierunku, od Markdown z powrotem do AsciiDoc, poprzez opcję kierunku.

Dodatkowe opcje kształtują szczegóły: styl nagłówków wybiera ATX (#) lub Setext (podkreślenie znaków = lub -, tylko poziomy jeden i dwa — głębsze nagłówki wracają do ATX); format ostrzeżenia wybiera zwykły cytat blokowy lub blok ostrzeżenia GitHub; styl punktów wybiera kreskę lub gwiazdkę dla list nienumerowanych i zachowuje atrybuty jako nagłówek zmienia linie :nazwa: wartość z AsciiDoc na blok YAML zamiast ich usuwania, odbijane również w kierunku odwrotnym.

To jest lekki konwerter oparty na wzorcach, a nie pełny parser, więc działa najlepiej z powyższymi konstrukcjami. Listy numerowane zawsze renderują się jako "1." lub "." — renderery numerują sekwencyjnie niezależnie od cyfr znacznika źródła, więc numeracja nie jest zagrożona. Zakończenia linii Windows i Unix są obsługiwane w ten sam sposób, a licznik raportuje linie wejście, wyjście i elementy przekonwertowane.

Wszystko działa lokalnie w przeglądarce podczas pisania — nic, co wklejasz, nie jest przesyłane, rejestrowane lub wysyłane gdziekolwiek. Skopiuj wynik, pobierz go jako plik .txt lub wyślij z powrotem do wejścia do następnego przebiegu.

Częste pytania

Czy to obsługuje oba kierunki — AsciiDoc na Markdown i Markdown na AsciiDoc?
Tak. Opcja kierunku przełącza, który format jest odczytywany i który jest produkowany, a zamiana jej również przesuwa bieżące wyjście z powrotem na wejście, dzięki czemu możesz konwertować w jedną stronę, a następnie sprawdzić podróż w obie strony.
Dlaczego listy numerowane zawsze wyświetlają się jako "1." lub "."?
Zarówno renderery Markdown jak i AsciiDoc numerują listy numerowane sekwencyjnie niezależnie od tego, która cyfra lub ile kropek siedzi na każdej linii źródła, więc pisanie każdego znacznika w ten sam sposób nadal produkuje prawidłowo numerowane dane wyjściowe bez konieczności śledzenia liczników przez konwerter.
Co się dzieje z konstrukcjami AsciiDoc, które to narzędzie nie rozpoznaje?
Wszystko poza obsługiwanym zestawem — nagłówkami, tekstem pogrubionym, linkami, obrazami, blokami list, tabelami jeden-wiersz-na-linię, ostrzeżeniami, listami i atrybutami :nazwa: wartość — jest pozostawiane jako zwykły tekst, a nie zgadywane, więc wynik pozostaje przewidywalny zamiast cicho przekształcać nieznane znaczniki.
Czy może konwertować tabele zagnieżdżone lub wielowierszowe?
Obsługuje kompaktną formę, w której każdy wiersz tabeli siedzi na własnej linii między ogranicznikami |=== (AsciiDoc) lub jako standardowa tabela z pomlčką z wierszem separatora (Markdown). Tabele AsciiDoc napisane z jedną komórką na linię i separatorami pustych linii nie są rekonstruowane.
Czy mój dokument jest przesyłany gdziekolwiek?
Nie. Konwersja odbywa się całkowicie w przeglądarce — nic, co wklejasz, nigdy nie opuści Twojego urządzenia.