Walidator YAML: sprawdzaj składnię YAML online
Walidator YAML pozwala sprawdzać online składnię plików YAML, takich jak docker-compose.yml, manifesty Kubernetes czy workflow CI. Narzędzie wskazuje wiersz i kolumnę błędu, a poprawny YAML zwraca w ujednoliconej postaci lub jako JSON – także gdy plik zawiera kilka dokumentów oddzielonych przez ---.
Autor: Jakub Martyniak
Bezpłatnie, bez rejestracji – Twój YAML jest sprawdzany tylko w przeglądarce i nie jest przesyłany na serwer.
Wdrażasz manifest Kubernetes? Możesz uruchamiać kontenery z pełnym dostępem root.
Dane wejściowe
Wynik
Wklej YAML po lewej stronie, aby zobaczyć podgląd.
Przykładowy wynik
Tak wygląda wynik w YAML Validator
Wklejasz YAML, a narzędzie wskazuje błędy składni wraz z numerem wiersza i kolumny albo zwraca poprawny YAML w postaci znormalizowanej lub jako JSON. Dwa poniższe pliki to stałe przykłady. Twój wynik zależy od Twojego pliku.
Przykład · Sprawdź poprawność i przekonwertuj na JSON
Dane wejściowe: wiersz 2 z wcięciem tabulatorem
server: name: zapWynik: diagnoza
- 1 błąd
Błąd · Wiersz 2, kolumna 1Tabs are not allowed as indentation
YAML pozwala używać do wcięć tylko spacji. Po zastąpieniu tabulatora dwiema spacjami plik będzie poprawny.
Dane wejściowe: poprawny YAML
server: name: zap port: 25565 tags: - eu - ddosWynik: JSON
{ "server": { "name": "zap", "port": 25565, "tags": [ "eu", "ddos" ] }}Jak to działa
Jak sprawdzić YAML online za pomocą walidatora
Pięć kroków od wklejenia YAML do sprawdzonego pliku lub JSON.
Krok 1
Wklej YAML
Wklej swój YAML w pole tekstowe, otwórz plik .yaml lub .yml przez „Wybierz plik” albo zacznij od przycisku „Wczytaj przykład”.
Krok 2
Wybierz tryb
Wybierz u góry „Waliduj” lub „Konwertuj na JSON”. Dla JSON-u ustaw wcięcia: 2 spacje, 4 spacje lub tabulator.
Krok 3
Odczytaj wynik
Sprawdzanie odbywa się automatycznie przy każdej zmianie. W trybie „Walidacja” po prawej stronie zobaczysz „Poprawny YAML.” albo listę błędów z numerem wiersza i kolumny, a przy wielu dokumentach również z numerem dokumentu.
Krok 4
Napraw błędy
Popraw wskazane miejsca w polu tekstowym. Wynik aktualizuje się po każdej zmianie.
Krok 5
Skopiuj lub pobierz
Skopiuj ujednolicony YAML lub JSON albo pobierz go jako validated.yaml lub converted.json.
Dlaczego to narzędzie?
Sprawdzanie YAML i konwersja YAML na JSON w jednym narzędziu
Oto, co potrafi walidator YAML — bezpośrednio w Twojej przeglądarce.
Kilka dokumentów w jednym pliku
Dokumenty oddzielone przez ---, np. w manifestach Kubernetes, są sprawdzane osobno. Komunikaty o błędach wskazują również numer dokumentu.
Błędy z numerem wiersza i kolumny
Błędy składni są wyświetlane z komunikatem oraz – jeśli parser potrafi określić ich położenie – numerem wiersza i kolumny. Na liście pojawia się maksymalnie 200 błędów.
Wykrywanie zduplikowanych kluczy
Jeśli klucz występuje dwa razy w jednym mapowaniu, narzędzie zgłasza błąd i wskazuje jego położenie.
Konwertuj YAML na JSON
W zakładce „Konwertuj na JSON” poprawny YAML jest zamieniany na JSON z wcięciami o szerokości 2 spacji, 4 spacji lub tabulatora. Możesz pobrać wynik jako converted.json.
Ujednolicony wynik z komentarzami
Poprawny YAML zostanie wyświetlony z nowymi wcięciami, a komentarze pozostaną zachowane. Skopiuj wynik lub pobierz go jako validated.yaml.
Działa tylko w przeglądarce
Sprawdzanie i konwersja odbywają się w Twojej przeglądarce, a pliki są odczytywane lokalnie. Twój YAML nie jest przesyłany na serwer.
Diagnostyka błędów
Typowe błędy YAML i sposoby ich naprawy
Walidator YAML zgłasza poniższe błędy. Same komunikaty o błędach pochodzą z biblioteki YAML i są po angielsku.
Tabulator zamiast spacji
server:
name: zapYAML dopuszcza we wcięciach tylko spacje. Jeśli wiersz ma wcięcie z tabulatora, narzędzie wskazuje jego numer i kolumnę. Zastąp tabulator spacjami.
Zduplikowany klucz
server:
port: 25565
port: 25566Jeśli ten sam klucz występuje dwa razy w jednym mapowaniu, narzędzie wyświetla komunikat „Map keys must be unique” przy drugim kluczu. Usuń jeden z nich lub zmień jego nazwę.
Niezamknięty nawias
tags: [eu, ddosLista w nawiasach kwadratowych bez nawiasu zamykającego powoduje, że plik jest niepoprawny. Zamknij nawias albo zapisz listę jako elementy zaczynające się od łącznika.
Alias bez kotwicy
app:
image: *baseAlias taki jak *base wymaga kotwicy &base umieszczonej wcześniej w tym samym dokumencie. Jeśli kotwicy brakuje lub występuje dopiero później, narzędzie zgłosi błąd.
Podstawy
Czym jest YAML i czym różni się od JSON?
Pliki YAML: .yaml i .yml
YAML to czytelny format danych używany w plikach konfiguracyjnych, na przykład Docker Compose, Kubernetes lub potoków CI. Strukturę tworzą wcięcia ze spacji, wartości mają postać klucz: wartość, elementy list zaczynają się od łącznika, a komentarze od #. Rozszerzenia .yaml i .yml oznaczają ten sam format — walidator YAML otwiera oba.
YAML czy JSON?
JSON zamiast wcięć używa nawiasów klamrowych i kwadratowych oraz nie obsługuje komentarzy. Poprawny YAML zamienisz na JSON w zakładce „Konwertuj na JSON”: pojedynczy dokument staje się bezpośrednio wartością JSON, a wiele dokumentów oddzielonych przez --- zamienia się w tablicę JSON. Komentarze są przy tym usuwane.
Odkryj więcej
Więcej narzędzi do Twoich plików konfiguracyjnych
Porównywanie tekstów online (Diff Checker)
Porównywanie tekstów online: Porównaj dwa teksty, konfiguracje lub wersje kodu, zobacz różnice w poszczególnych wierszach i słowach oraz skopiuj wynik jako Unified Diff. Wszystko działa w przeglądarce.
Autor: Dimitri Heissler
Formatowanie JSON
Formatuj, minimalizuj i sprawdzaj poprawność JSON – z podświetlaniem składni, komunikatami o błędach i możliwością pobrania, w całości w przeglądarce.
Autor: Jakub Martyniak
Formater i walidator XML
Sprawdzaj poprawność, formatuj, minimalizuj i automatycznie naprawiaj XML (niezamaskowane znaki, brakujące tagi i deklaracje) — w 100% w przeglądarce, bez przesyłania plików.
Autor: Justin Schuessler
Koder/dekoder Base64
Koduj i dekoduj tekst w Base64 — także w wariancie bezpiecznym dla adresów URL, z czytelnymi komunikatami o błędach. Wszystko w przeglądarce.
Autor: Jakub Martyniak
Generator Crontab
Twórz wyrażenia Cron za pomocą formularza, z objaśnieniami po polsku i podglądem najbliższych terminów wykonania — wszystko w przeglądarce.
Autor: Jakub Martyniak
FAQ
Często zadawane pytania o walidator YAML
Krótkie odpowiedzi o YAML i tym narzędziu.
Tak. Walidator YAML jest bezpłatny i nie wymaga rejestracji, konta ani instalacji.
Nie. Sprawdzanie i konwersja odbywają się w całości w Twojej przeglądarce, a plik wybrany przez „Wybierz plik” jest odczytywany lokalnie. Twój YAML nie jest wysyłany na serwer ani zapisywany. Przydaje się to przy konfiguracjach zawierających hasła lub tokeny.
Wklej swój YAML w pole tekstowe lub otwórz plik .yaml albo .yml przez „Wybierz plik”. Sprawdzanie odbywa się automatycznie przy każdej zmianie, bez wysyłania formularza. W trybie „Walidacja” po prawej stronie pojawi się „Poprawny YAML.” albo lista błędów z numerem wiersza i kolumny, a przy wielu dokumentach również z numerem dokumentu. Osobno wyświetlanych jest do 200 błędów, pozostałe są podsumowywane.
YAML dopuszcza we wcięciach tylko spacje. Jeśli wiersz ma wcięcie z tabulatora, narzędzie wyświetla komunikat „Tabs are not allowed as indentation” z numerem wiersza i kolumny – w powyższym przykładzie jest to wiersz 2, kolumna 1. Zastąp tabulator spacjami, a plik będzie poprawny.
Tak. Dokumenty oddzielone przez ---, jak w manifestach Kubernetes, są sprawdzane osobno. Komunikat o błędzie wskazuje również dokument, w którym wystąpił błąd, a przy poprawnym YAML-u status pokazuje liczbę dokumentów. --- na końcu pliku nie jest liczone jako osobny dokument.
Przejdź do zakładki „Konwertuj na JSON” i wybierz wcięcia: 2 spacje, 4 spacje lub tabulator. Pojedynczy dokument staje się bezpośrednio wartością JSON, a kilka dokumentów – tablicą JSON. Możesz skopiować JSON lub pobrać go jako converted.json.
Tak, w trybie „Waliduj”. Narzędzie wyświetla poprawny YAML w ujednoliconej postaci, z ponownie ustawionymi wcięciami i zachowanymi komentarzami #. Twój tekst wejściowy pozostaje bez zmian. Wynik JSON nie zawiera komentarzy, ponieważ JSON ich nie obsługuje.
Nie. Walidator YAML sprawdza składnię YAML: wcięcia, strukturę, zduplikowane klucze i aliasy bez pasującej kotwicy. Nie sprawdza, czy plik docker-compose.yml lub manifest Kubernetes zawiera właściwe pola.
Masz dodatkowe pytania?
Kontakt z pomocą technicznąTwoja aplikacja lub API potrzebuje niezawodnego serwera
VPS na ZAP-Hosting zapewnia niezawodne działanie twojej aplikacji lub twojego projektu online.
Bez konfiguracji. Bez ryzyka. Online w kilka sekund.
Szukasz więcej narzędzi? Zobacz wszystkie narzędzia dla programistów
