Przejdź do treści
Bezpłatne narzędzie

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

config.yml
server:	name: zap

Wynik: 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

config.yml
server:  name: zap  port: 25565  tags:    - eu    - ddos

Wynik: JSON

config.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.

  1. 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”.

  2. 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.

  3. 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.

  4. Krok 4

    Napraw błędy

    Popraw wskazane miejsca w polu tekstowym. Wynik aktualizuje się po każdej zmianie.

  5. 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: zap

YAML 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: 25566

Jeś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, ddos

Lista 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: *base

Alias 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

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ą
Tworzysz właśnie coś własnego?

Twoja aplikacja lub API potrzebuje niezawodnego serwera

VPS na ZAP-Hosting zapewnia niezawodne działanie twojej aplikacji lub twojego projektu online.

4,4/5 Trustpilot32.000+ Aktywne serweryOd 2010 roku

Bez konfiguracji. Bez ryzyka. Online w kilka sekund.

Elastyczny okres obowiązywaniaAnuluj w dowolnym momencieOnline w 60 sekund

Szukasz więcej narzędzi? Zobacz wszystkie narzędzia dla programistów