Formatter Markdown
Uporządkuj Markdown za pomocą tego formattera Markdown. Wklej README, stronę dokumentacji lub notatki, a narzędzie usunie początkowe i końcowe puste wiersze oraz wyrówna wszystkie tabele z pionowymi kreskami: szerokość komórek zostanie dopasowana do najdłuższej zawartości w kolumnie, a wiersz separatora zostanie utworzony ponownie z odpowiednią liczbą myślników, z zachowaniem dwukropków określających wyrównanie. Cała pozostała treść zostanie zachowana, dzięki czemu autorzy tekstów i programiści otrzymają schludne tabele bez niespodzianek.
Najczęściej zadawane pytania
Co zmienia formatter Markdown?
Wyrównuje tabele z pionowymi kreskami oraz usuwa puste wiersze i spacje z początku i końca dokumentu. Nagłówki, akapity, listy, linki i wyróżnienia pozostają dokładnie takie, jak zostały napisane.
Jak formatowane są tabele?
Każdy wiersz otrzymuje pionową kreskę na początku i na końcu, każda komórka jest dopełniana spacjami do szerokości najdłuższej komórki w kolumnie, a szerokość kolumny wynosi co najmniej trzy znaki. Wiersz separatora jest tworzony ponownie z myślnikami o tej samej szerokości.
Czy wyrównanie kolumn zostaje zachowane?
Tak, dwukropki w wierszu separatora są zachowywane. Wyrównanie do lewej, do środka i do prawej, zapisane jako :---, :---: i ---:, pozostaje bez zmian po formatowaniu.
Czy tabele w blokach kodu są zmieniane?
Nie, zawartość między blokami oznaczonymi trzema znakami backtick lub trzema tyldami pozostaje bez zmian. Dotyczy to także tekstu wewnątrz bloków kodu, który wygląda jak tabela.
Dlaczego kolumny z literami diakrytycznymi lub emoji wyglądają na niewyrównane?
Szerokość komórek jest mierzona w bajtach UTF-8, dlatego znaki spoza ASCII zajmują od dwóch do czterech bajtów. W zwykłym edytorze tekstu kolumny zawierające takie znaki mogą otrzymać dodatkowe dopełnienie, ale nie wpływa to na wyrenderowaną tabelę.
Czy narzędzie zmienia znaczniki list lub style nagłówków?
Nie, znaczniki list, numeracja, znaczniki nagłówków i odstępy wewnątrz akapitów są zachowywane w niezmienionej formie. Formatter działa zachowawczo, więc nigdy nie zmienia sposobu renderowania dokumentu.
Czy sformatowany dokument renderuje się inaczej?
Nie, dopełnienie komórek tabeli i usunięcie zewnętrznych pustych wierszy dokumentu nie zmieniają wyniku renderowania. GitHub, GitLab i inne renderery wyświetlają te same tabele przed formatowaniem i po nim.
Czy mogę używać tego narzędzia do plików MDX?
Tak, ale lepiej sprawdzi się formatter MDX, ponieważ oznacza wynik jako mdx. Oba narzędzia stosują te same reguły i pozostawiają importy oraz JSX bez zmian.
Dlaczego wynik jest otoczony blokiem kodu markdown?
Wynik jest zwracany w bloku kodu oznaczonym jako markdown, więc po wklejeniu do przeglądarki Markdown wyświetla się jako kod źródłowy. Skopiuj wiersze między zewnętrznymi znacznikami bloku do pliku .md.
Jak duży może być mój dokument?
Do 5 MB na jedno uruchomienie; większe dane wejściowe zostają odrzucone z komunikatem. Wynik jest identyczny z opcją Markdown w narzędziu Code Formatter.