To narzędzie do formatowania tabeli Markdown wyrównuje kreski pionowe we wszystkich tabelach dokumentu i nie zmienia reszty tekstu. Wystarczy wkleić nieuporządkowaną tabelę lub całe README i skopiować uporządkowaną wersję.
Ostatnia aktualizacja:
Jak to działa
Wklej Markdown
Można wkleić jedną tabelę albo cały dokument, upuścić plik .md lub otworzyć go z adresu URL. Znalezione zostaną wszystkie tabele, a bloki kodu są pomijane.
Wybierz styl
W polu „Wyrównanie” można zostawić ustawienie „Jak w źródle” lub narzucić je wszystkim kolumnom, a przełącznik „Wyrównaj kolumny” decyduje, czy kreski mają stać równo, czy zapis ma być zwarty.
Skopiuj wynik
Sformatowany dokument pojawia się po prawej stronie razem z podglądem; można go skopiować albo pobrać jako .md.
Funkcje
Całe dokumenty
Nagłówki, listy, kod i tekst między tabelami pozostają nietknięte co do bajtu; zmieniają się tylko linie tabel, z zachowaniem znaków końca wiersza dokumentu.
Szerokość znaków ma znaczenie
Znaki chińskie, japońskie i koreańskie oraz emoji liczą się jako dwie kolumny, więc kreski stoją równo w edytorze z czcionką o stałej szerokości.
Naprawy
Krótsze wiersze dostają puste komórki, wiersz separatora – po jednym segmencie na kolumnę, a brakujące zewnętrzne kreski są dopisywane.
Treść komórek bez zmian
Zawartość komórek zostaje dokładnie taka sama: maskowane kreski, kod, linki i <br> nie są zmieniane, więc wyrenderowana tabela wygląda identycznie.
Jedna tabela lub wszystkie
Można sformatować wszystkie tabele naraz albo wybrać z listy jedną i zostawić pozostałe bez zmian.
Limity i prywatność
Dokumenty mogą mieć do 10 MB. Pliki powyżej 5 MB są formatowane bezpośrednio z pliku, bez wczytywania do edytora.
Tabele w listach lub cytatach blokowych oraz tabele HTML zostają bez zmian. Tabela, której wiersz separatora ma inną liczbę kolumn niż nagłówek, nie jest tabelą także dla GitHuba, więc nie jest zmieniana – najpierw trzeba poprawić nagłówek. Tabela zaczynająca się zaraz po linii akapitu jest rozpoznawana, tak jak na GitHubie.
Gdy w dokumencie trzeba poprawić nie tylko tabele, ale też listy, nagłówki i odstępy, przyda się formatowanie Markdown dla całego pliku.
Formatowanie odbywa się w przeglądarce – więcej na stronie o prywatności.
Najczęstsze pytania
Jak sformatować tabelę Markdown?
Wystarczy ją wkleić. Kreski pionowe są wyrównywane od razu, a wynik można skopiować z powrotem do pliku.
Czy zmieni się zawartość komórek?
Nie. Zmieniają się tylko spacje, kreski pionowe i wiersz separatora, więc tabela wyświetla się dokładnie tak jak wcześniej.
Czy można sformatować wszystkie tabele w README naraz?
Tak. Wystarczy wkleić całe README: każda tabela zostanie sformatowana, a reszta dokumentu pozostanie bez zmian.
Czy polskie znaki i emoji psują wyrównanie kolumn?
Nie. Litery takie jak ą, ł czy ż zajmują jedną kolumnę, a emoji oraz znaki chińskie, japońskie i koreańskie – dwie. Narzędzie uwzględnia tę różnicę, więc tabela wygląda równo w edytorze z czcionką o stałej szerokości.
Co się dzieje z wierszem, który ma za dużo komórek?
GitHub ignoruje komórki wykraczające poza szerokość nagłówka, dlatego są one usuwane, a ostrzeżenie podaje numer linii.
Jak uzyskać zwartą tabelę?
Wystarczy wyłączyć „Wyrównaj kolumny”. Każda komórka ma wtedy po jednej spacji z każdej strony, dzięki czemu diffy w pull requestach są mniejsze.
Czy to działa tak samo jak Prettier?
Wynik jest zbliżony do formatowania tabel przez Prettier, ale nie trzeba niczego instalować, a dodatkowo można zmienić wyrównanie kolumn.