Jak używać
- Wpisz nagłówek w pierwszym wierszu, a dane poniżej albo otwórz „Wypełnij z CSV…” i wklej komórki z arkusza kalkulacyjnego.
- Dodawaj lub usuwaj wiersze i kolumny za pomocą przycisków.
- Ustaw wyrównanie każdej kolumny za pomocą menu nad nią.
- Wybierz Markdown lub HTML i skopiuj lub pobierz tabelę.
Jak to działa
Dane wyjściowe Markdown są zgodne ze składnią tabel GitHub Flavored Markdown (GFM), którą obsługują GitHub, GitLab, wiele generatorów dokumentacji i większość edytorów Markdown. Pierwszy wiersz staje się nagłówkiem, po nim następuje wiersz separatora określający wyrównanie: :--- dla wyrównania do lewej, :---: do środka, ---: do prawej, a --- dla domyślnego.
Zawartość komórek jest przekształcana tak, aby nie naruszyć tabeli: znak | wewnątrz komórki jest zapisywany jako \|, a podział wiersza staje się <br>, ponieważ wiersz tabeli GFM musi pozostać w jednej linii. Inne elementy Markdown w komórkach, takie jak **pogrubienie** czy `kod`, są zachowywane i renderowane przez przeglądarkę Markdown. Po włączeniu opcji „Wyrównaj kolumny spacjami” każda kolumna jest dopełniana do tej samej szerokości, dzięki czemu tabela jest czytelna jako zwykły tekst; znaki chińskie, japońskie i koreańskie liczą się jako szerokość dwóch kolumn. Wiersze z mniejszą liczbą komórek są uzupełniane pustymi komórkami.
Import akceptuje tekst rozdzielany tabulatorami (czyli to, co arkusze kalkulacyjne umieszczają w schowku), CSV z przecinkami lub średnikami, w tym pola w cudzysłowach z przecinkami, cudzysłowami i podziałami wierszy, a także istniejące tabele Markdown, których wiersz wyrównania jest również odczytywany.
Wyjście HTML to zwykła tabela <table> z elementami <thead> i <tbody>. Tekst jest zamieniany na encje HTML (& < > "), podziały wierszy stają się <br>, a wyrównanie jest ustawiane za pomocą stylów inline text-align, dzięki czemu działa bez arkusza stylów.
Przykłady
Arkusz kalkulacyjny do README
Zaznacz zakres w Google Sheets, skopiuj go, wklej do pola importu i kliknij „Wypełnij tabelę”. Ustaw kolumnę ceny na wyrównanie do prawej i skopiuj Markdown do pliku README.md.
Tekst ze znakiem |
Komórka zawierająca „Unlimited | fair use” jest zapisywana jako Unlimited \| fair use, dzięki czemu GitHub wyświetla pionową kreskę zamiast rozpoczynać nową kolumnę.
Porządkowanie istniejącej tabeli
Wklej ręcznie napisaną tabelę Markdown o nierównych odstępach, kliknij „Wypełnij tabelę” i skopiuj wynik z powrotem, z wyrównanymi kolumnami i zachowanym wyrównaniem.
Często zadawane pytania
Czy komórka może zawierać podział wiersza?
Nie jako prawdziwy podział wiersza, ponieważ każdy wiersz tabeli w Markdown musi być jedną linią. Generator zapisuje zamiast tego <br>, co GitHub i większość przeglądarek wyświetla jako podział wiersza.
Dlaczego musi być wiersz nagłówka?
Tabele GFM zawsze zaczynają się od wiersza nagłówka, po którym następuje wiersz wyrównania. Jeśli nie chcesz widocznych nagłówków, możesz zostawić komórki nagłówka puste, ale większość przeglądarek Markdown nadal rysuje linię nagłówka.
Czy mogę scalać komórki?
Nie. Tabele Markdown nie obsługują scalonych komórek (colspan ani rowspan). Jeśli ich potrzebujesz, użyj wyniku HTML i dodaj atrybuty colspan lub rowspan ręcznie.
Czy wyrównanie spacjami zmienia wygląd tabeli po wyrenderowaniu?
Nie. Dodatkowe spacje są ignorowane podczas renderowania Markdown. Wyrównanie spacjami tylko ułatwia czytanie i edycję kodu źródłowego.
Prywatność
Tabela jest tworzona wyłącznie w Twojej przeglądarce. Wpisywane lub wklejane dane nie są przesyłane, przechowywane ani uwzględniane w analityce.