Ten konwerter YAML na tabelę Markdown zamienia listę mapowań YAML w tabelę GitHub Flavored Markdown: każdy element to wiersz, a każdy klucz – kolumna. Wystarczy wkleić YAML lub otworzyć plik .yaml i skopiować tabelę.
Ostatnia aktualizacja:
Jak to działa
Wklej lub otwórz YAML
Można wkleić YAML, upuścić plik .yaml lub .yml albo otworzyć go z adresu URL. Lista na najwyższym poziomie lub pod kluczem, np. services:, jest znajdowana automatycznie.
Wybierz listę i kolumny
Inną listę wskazuje ścieżka w polu „Tablica do konwersji”. Do wyboru jest też sposób zapisu zagnieżdżonych list oraz ukrywanie i przestawianie kolumn.
Skopiuj Markdown
Tabelę można skopiować prosto do dokumentacji albo pobrać jako plik .md.
Funkcje
Pliki konfiguracyjne jako tabele
Usługi z pliku Docker Compose, zadania potoku CI, flagi funkcji czy klucze tłumaczeń można udokumentować w postaci czytelnej tabeli.
Pełna obsługa YAML
Kotwice, aliasy i klucze scalające (<<) są rozwiązywane, komentarze pomijane, a kilka dokumentów rozdzielonych --- jest czytanych jako lista.
Spłaszczanie zagnieżdżonych kluczy
Mapowanie wewnątrz elementu zamienia się w kolumny z kropką, np. resources.limits.cpu; listy mogą być numerowanymi kolumnami, tekstem JSON lub połączonymi wartościami.
YAML 1.1 lub 1.2
Pole „Schemat YAML” decyduje o interpretacji: YAML 1.2 core zostawia yes i no jako tekst, a YAML 1.1 – tak jak starsze parsery – czyta je jako true i false.
Limity i prywatność
Pliki YAML mogą mieć do 10 MB, a tabele są ograniczone do 50 000 wierszy. Pliki powyżej 5 MB są konwertowane bezpośrednio z pliku, bez wczytywania do edytora.
Dobre tabele powstają tylko z list rekordów. Głęboko zagnieżdżoną konfigurację z niewieloma powtarzającymi się elementami lepiej czytać w oryginalnym YAML albo przekonwertować narzędziem YAML na JSON. Długie wartości wielowierszowe (bloki zaczynające się od |) trafiają do jednej komórki z <br> między liniami, co może mocno poszerzyć tabelę – jeśli potrzebny jest tylko przegląd, takie kolumny warto ukryć.
Nic nie jest wysyłane na serwer – więcej na stronie o prywatności.
Najczęstsze pytania
Jak zamienić YAML na tabelę Markdown?
Wystarczy wkleić YAML. Jeśli zawiera listę mapowań, każdy jej element staje się wierszem; tabelę Markdown po prawej stronie wystarczy skopiować.
Plik zawiera kilka dokumentów rozdzielonych ---. Czy to problem?
Nie. Kolejne dokumenty są czytane jako lista, więc każdy z nich staje się wierszem tabeli – wygodne, gdy w jednym pliku jest kilka podobnych wpisów konfiguracji.
Co, jeśli mój YAML to pojedyncze mapowanie?
Wpisanie $ w polu „Tablica do konwersji” daje tabelę z jednym wierszem i kolumną dla każdego klucza. Można też wskazać listę zagnieżdżoną w mapowaniu.
Czy znaczniki takie jak !!python/object są wykonywane?
Nie. Nieznane znaczniki nigdy nie są uruchamiane; ich wartości zostają zwykłym tekstem, a ostrzeżenie podaje ich nazwy.
Dlaczego klucz pokazuje się jako on albo true?
YAML 1.1 czyta on, yes i no jako wartości logiczne. Aby zachować je jako tekst, wystarczy przełączyć „Schemat YAML” na „YAML 1.2 core”.
Czy YAML jest wysyłany na serwer?
Nie. Jest analizowany w wątku Web Worker w przeglądarce i nie opuszcza urządzenia.