Brak danych wejściowych.
Formatter Markdown z kontrolą renderowania
To narzędzie do formatowania Markdown przepisuje dokument w jednolitym stylu – punktory, nagłówki, listy numerowane, wcięcia, tabele i puste linie – a potem sprawdza, czy wyrenderowany HTML się nie zmienił. Wystarczy wkleić Markdown i pobrać uporządkowaną wersję.
Ostatnia aktualizacja:
Jak to działa
Wklej Markdown
Wystarczy wkleić tekst, otworzyć plik .md lub wczytać go z adresu URL. Przykład to celowo nieuporządkowany changelog.
Wybierz styl
Do wyboru są znak punktora, numeracja, znaczniki wyróżnień, ograniczniki bloków kodu i sposób zapisu twardych podziałów wierszy. Każda opcja może też zostawić oryginał („Bez zmian”).
Sprawdź i pobierz
Wystarczy porównać sformatowany tekst, przejrzeć kartę „Zmiany” i wynik kontroli renderowania, a potem skopiować lub pobrać plik.
Funkcje
Dowód, że nic nie zginęło
Wejście i wynik są renderowane parserem CommonMark, a powstały HTML jest porównywany. Zielony znacznik oznacza, że zmieniło się tylko formatowanie źródła.
Porządne listy
Jeden znak punktora, przenumerowane listy numerowane i elementy zagnieżdżone wcięte pod tekstem rodzica. Lista zaczynająca się innym znacznikiem pozostaje osobną listą.
Wyrównane tabele
Kreski pionowe stoją w jednej linii, komórki są dopełniane spacjami, a wiersz wyrównania zachowuje :--, :-: i --: bez zmian.
Nagłówki i linie poziome
Podkreślone nagłówki stają się nagłówkami #, zamykające krzyżyki i zbędne spacje znikają, a linie *** lub ___ zamieniają się w ---.
Kod nietknięty
Bloki kodu (z ogranicznikami i wcięte), bloki HTML i front matter są kopiowane bez zmian.
Zawsze ten sam wynik
Formatowanie jest deterministyczne i idempotentne: ponowne uruchomienie na wyniku niczego nie zmienia.
Limity i prywatność
Dokumenty do 5 MB. Formatowanie i kontrola renderowania działają w przeglądarce (duże dokumenty w wątku roboczym w tle); tekst nie jest wysyłany na serwer ani nigdzie zapisywany. Więcej na stronie o prywatności.
Najczęstsze pytania
Jak sformatować plik Markdown?
Wystarczy go wkleić lub upuścić plik .md, zostawić domyślny styl i pobrać wynik. Karta „Zmiany” pokazuje, co zostało przepisane.
Czy formatowanie zmieni wygląd README?
Nie. Kontrola renderowania porównuje HTML przed i po. Zmieniają się tylko odstępy, znaczniki i wyrównanie w kodzie źródłowym.
Dlaczego „#Tytuł” nie staje się nagłówkiem?
Bez spacji po # CommonMark i GitHub pokazują go jako zwykły tekst. Zamiana na nagłówek zmieniłaby dokument, więc ta linia zostaje bez zmian.
Punktory * czy -?
Oba renderują się tak samo. Łącznik to najczęstszy wybór w przewodnikach stylu i linterach – ważne, aby trzymać się jednego.
Co robi opcja „Uporządkuj puste linie”?
Zwija serie pustych linii do jednej i dodaje pustą linię wokół nagłówków, bloków kodu i tabel, czego wymagają niektóre renderery.
Czy to to samo co Prettier lub markdownlint?
Narzędzie obejmuje typowe reguły formatowania z tych programów bez instalowania czegokolwiek i dodaje widoczną kontrolę renderowania. Nie sprawdza treści ani linków.