Jak utworzyć plik XML - przykład i struktura

Czym jest plik XML i do czego służy?

Jak utworzyć plik XML najłatwiej zrozumieć, gdy potraktujesz XML 1.0 jako tekstowy sposób zapisywania uporządkowanych danych: dokument ma jeden element główny, opisowe tagi i czytelną hierarchię. Standard W3C z 2008 roku określa reguły takiej składni, a kodowanie UTF-8 pozwala bez problemu zapisać polskie znaki.

Co to jest XML?

XML to rozszerzalny język znaczników służący do opisywania danych, charakteryzujący się własnymi nazwami tagów, zagnieżdżoną strukturą i ścisłymi regułami składni. Nie jest językiem programowania, więc sam nie wykonuje poleceń ani nie tworzy interfejsu programu.

Plik XML spotkasz w konfiguracji aplikacji, eksporcie danych z księgowości, mapach witryn sitemap.xml, plikach wymiany danych, katalogach produktów i dokumentach branżowych. System zapisuje dane w tagach, dzięki czemu drugi system wie, co oznacza konkretny fragment tekstu.

• Konfiguracja programu - plik XML może zapisywać ustawienia, takie jak język aplikacji, folder roboczy i adres serwera.
• Sitemap.xml - mapa witryny przekazuje wyszukiwarce adresy stron oraz informacje o ich aktualizacji.
• Eksport produktów - sklep może przekazać nazwę, cenę, kod SKU i stan magazynowy w jednym uporządkowanym pliku XML.
• Wymiana dokumentów - systemy firmowe używają XML, gdy muszą przekazać dane w stałej, opisanej strukturze.
• Ustawienia urządzeń - niektóre aplikacje, drukarki i narzędzia administracyjne zapisują profile właśnie w XML.

XML nie zastępuje HTML. HTML przede wszystkim opisuje strukturę treści wyświetlanej na stronie, a XML opisuje znaczenie danych. Jeśli zapiszesz w XML tag cena, program rozpozna informację o cenie, ale przeglądarka nie zrobi z niej automatycznie ładnej karty produktu.

Z mojej praktyki redakcyjnej: przy pierwszym pliku nie próbuj od razu modelować całej bazy. Zacznij od jednego produktu albo jednego kontaktu. Błędy zagnieżdżania wychodzą wtedy od razu, a późniejsze rozbudowanie struktury XML jest bezpieczniejsze.

„Parafraza: dokument XML musi spełniać reguły poprawnej składni, zanim procesor XML zacznie go wiarygodnie odczytywać.” - W3C, Extensible Markup Language (XML) 1.0 (Fifth Edition), 2008.

Podstawowa struktura dokumentu XML

Struktura XML to deklaracja opcjonalna, dokładnie jeden element główny oraz poprawnie zagnieżdżone elementy potomne. Każdy otwarty tag musi mieć pasujący tag zamykający, a nazwy Produkt i produkt są różne, ponieważ XML 1.0 rozróżnia wielkość liter (źródło: W3C, 2008).

Czy XML musi mieć jeden element główny?

Tak, poprawny dokument XML ma dokładnie jeden element główny, zwany też root element. Może on zawierać wiele elementów potomnych, ale obok niego nie może wystąpić drugi niezależny korzeń.

W pliku z ofertą takim elementem może być oferta, a w pliku z kontaktami kontakty. Wszystkie dane powinny znaleźć się wewnątrz tego jednego kontenera. To podstawowa reguła dokumentu well-formed XML.

Jak działają tagi i zagnieżdżanie elementów?

Najpierw wpisz tag otwierający, potem jego treść albo elementy potomne, a na końcu tag zamykający z ukośnikiem. Kolejność zamykania musi być odwrotna do kolejności otwierania.

Dobry układ wygląda tak: <produkt>, wewnątrz <nazwa>Mysz USB</nazwa>, a następnie </produkt>. Błędny układ to zamknięcie produkt przed zamknięciem nazwa. Właśnie takie pomyłki najczęściej widzę w plikach tworzonych ręcznie.

Jak nazywać tag XML?

Tag XML nazwij krótkim słowem opisującym dane, na przykład email, cena_brutto lub numerZamowienia. Nie używaj spacji, nie zaczynaj nazwy od cyfry i nie zmieniaj przypadkowo wielkości liter.

• Tag opisowy - nazwa data_wysylki jasno mówi, że przechowuje datę wysłania.
• Stały styl nazw - wybierz zapis cenaBrutto albo cena_brutto i stosuj go w całym pliku.
• Wielkość liter - tag Klient nie jest tym samym co tag klient.
• Tag zamykający - element <telefon> musi kończyć się jako </telefon>.
• Element pusty - gdy danych nie ma, możesz użyć skrótu <uwagi />, o ile importer go akceptuje.

Poprawny plik XML ma jeden element główny, prawidłowo zagnieżdżone elementy oraz zamknięte tagi w odpowiedniej kolejności, czego wymaga XML 1.0 W3C.

Jak utworzyć plik XML w Notatniku?

Jak utworzyć plik XML w Notatniku? Wykonaj 6 kroków: otwórz Notepad, wpisz deklarację, dodaj element główny i dane, zapisz plik jako .xml, wybierz UTF-8, a potem sprawdź dokument w przeglądarce lub edytorze. Notepad wystarcza do prostych plików, choć Visual Studio Code wygodniej pokazuje strukturę.

Jak dodać deklarację XML?

Zacznij od pierwszej linii: <?xml version="1.0" encoding="UTF-8"?>. Deklaracja XML nie jest obowiązkowa w każdym pliku, ale przy polskich znakach i wymianie danych wyraźnie wskazuje wersję oraz oczekiwane kodowanie.

Deklaracja musi być pierwszym zapisem w pliku. Nie wpisuj przed nią spacji, komentarza ani zwykłego tekstu. Jeśli deklarujesz UTF-8, sam plik również zapisz jako UTF-8.

Jak dodać dane w zagnieżdżonych elementach?

W drugim kroku utwórz jeden element główny, na przykład <produkty>, a w nim elementy <produkt>. Każdy produkt może mieć nazwę, cenę, walutę i kod, co daje czytelną strukturę dla człowieka oraz importera.

Przykład prostego pliku XML możesz wpisać liniami:

<?xml version="1.0" encoding="UTF-8"?>
<produkty>
  <produkt id="P-100">
    <nazwa>Klawiatura bezprzewodowa</nazwa>
    <cena waluta="PLN">129.99</cena>
    <dostepny>tak</dostepny>
  </produkt>
</produkty>

Jak zapisać plik z rozszerzeniem .xml?

W Notatniku kliknij Plik > Zapisz jako, w polu „Nazwa pliku” wpisz na przykład produkty.xml, a w polu „Zapisz jako typ” wybierz Wszystkie pliki. W polu kodowania wybierz UTF-8, następnie kliknij „Zapisz”.

• Otwórz Notatnik - w menu Start wpisz „Notatnik” i uruchom zwykły edytor tekstu Windows.
• Wpisz deklarację - dodaj linię z wersją XML 1.0 oraz kodowaniem UTF-8.
• Dodaj root element - wpisz otwierający i zamykający tag, na przykład produkty.
• Utwórz dane - umieść każdy rekord w osobnym elemencie produkt z polami potomnymi.
• Wybierz Wszystkie pliki - ta opcja zapobiega zapisaniu dokumentu jako produkty.xml.txt.
• Sprawdź rozszerzenie - w Eksploratorze plików włącz widok Widok > Pokaż > Rozszerzenia nazw plików.

Nie pobieraj przypadkowych „generatorów XML” z reklam z hasłem „pobierz teraz”. Część takich instalatorów dodaje niechciane programy. Do ręcznego tworzenia wystarcza Notepad, a do większych plików pobierz Visual Studio Code wyłącznie z oficjalnej strony producenta.

Plik XML można przygotować w Notatniku, zapisując dokument jako .xml w UTF-8; deklaracja kodowania i faktyczny zapis pliku muszą być zgodne, aby polskie znaki nie zamieniły się w błędne symbole.

Przykład XML: lista produktów

Przykład pliku XML z listą produktów pokazuje, jak połączyć element główny produkty, powtarzalne rekordy produkt i krótkie atrybuty, takie jak identyfikator lub waluta. Taki wzór jest prostszy do rozbudowy niż jeden długi tag z wszystkimi danymi w atrybutach.

Jak dodać drugi produkt do XML?

Skopiuj cały element <produkt>...</produkt>, wklej go przed końcowym tagiem </produkty> i zmień identyfikator oraz wartości. Nie dopisuj nowego produktu za tagiem zamykającym element główny.

Czy jeden tag może zawierać kilka wartości?

Tak, ale gdy wartość ma własne cechy albo może się zmieniać niezależnie, utwórz osobny element. Na przykład kolor, stan magazynowy i producent są zwykle czytelniejsze jako osobne tagi niż jako jeden opis tekstowy.

Dane produktu	Przykład XML	Dlaczego tak
Nazwa	<nazwa>Monitor 24 cali</nazwa>	Nazwa może być długa i zawierać polskie znaki.
Cena	<cena waluta="PLN">699.00</cena>	Kwota jest wartością, a waluta krótką metadaną.
Identyfikator	<produkt id="P-101">	Id pozostaje zwięzły i jednoznaczny.
Dostępność	<dostepny>nie</dostepny>	Importer może łatwo odczytać stan logiczny.

• Produkt P-100 - identyfikator może łączyć rekord XML z numerem w sklepie lub magazynie.
• Cena 129.99 PLN - zapis z kropką wymaga sprawdzenia dokumentacji importera, bo nie każdy system przyjmuje przecinek.
• Stan „tak” - system docelowy może oczekiwać zamiast tego wartości true albo 1.
• Lista produktów - każdy rekord powinien używać identycznej kolejności pól, jeśli importer ma własne wymagania.

Gdy XML pochodzi z programu księgowego, marketplace albo urzędu, nie zmieniaj dowolnie nazw tagów. Najpierw sprawdź opis importu i wymagany schemat XSD. Sam fakt, że plik otwiera się w przeglądarce, nie daje gwarancji zgodności z formatem branżowym.

Elementy XML i atrybuty - kiedy wybrać które rozwiązanie?

Element XML przechowuje właściwą treść danych, a atrybut XML zwykle opisuje krótki parametr elementu, taki jak ID, jednostka lub waluta. W przykładzie produktu cena powinna być elementem, a waluta atrybutem, ponieważ kwota ma samodzielne znaczenie i może wymagać dalszej struktury.

Czym różni się atrybut XML od elementu XML?

Atrybut zapisujesz wewnątrz tagu otwierającego jako para nazwa i wartość, a element ma osobny tag otwierający, treść i tag zamykający. Atrybut nie nadaje się dobrze do długiego tekstu ani do danych zagnieżdżonych.

Kiedy użyć elementu zamiast atrybutu?

Użyj elementu, gdy dane mogą być dłuższe, wielokrotne albo rozbudowane w przyszłości. Element adres może później zawierać ulicę, kod pocztowy i miasto, podczas gdy atrybut typ="dostawa" pozostaje krótkim opisem.

• Atrybut id - zapis id="P-100" dobrze pasuje do krótkiego identyfikatora rekordu.
• Atrybut waluta - zapis waluta="PLN" opisuje kwotę bez powtarzania długiego tekstu.
• Element opis - dłuższy opis produktu powinien trafić do osobnego tagu opis.
• Element adres - adres warto rozbić na pola, jeżeli dane mają trafić do formularza lub etykiety.
• Element telefon - numer telefonu jako element łatwiej rozszerzyć o typ, kraj lub potwierdzenie.

W plikach, które później ktoś edytuje ręcznie, polecam przewagę elementów nad przeładowanymi atrybutami. Taki XML czyta się szybciej, a XPath łatwiej wskaże potrzebne pole. Jeśli porównujesz formaty wymiany danych, zobacz też XML a JSON - najważniejsze różnice.

Znaki specjalne XML, encje i CDATA

Znaki specjalne XML obejmują między innymi ampersand, znak mniejszości i znak większości, które w zwykłym tekście mogą zostać potraktowane jak część składni. Aby zachować poprawność XML 1.0, zapisuj je jako encje: &amp;, &lt; i &gt; (źródło: W3C, 2008).

Jak wpisać znak ampersand w XML?

Zamiast zwykłego znaku & wpisz sekwencję &amp;. Przykład: nazwa „Kawa & herbata” powinna w XML wyglądać jako „Kawa &amp; herbata”.

Kiedy użyć CDATA?

Użyj CDATA, gdy pole ma zawierać duży fragment tekstu z symbolami przypominającymi tagi, na przykład kod lub opis techniczny. CDATA nie zastępuje encji w każdej sytuacji i nie może zawierać sekwencji kończącej ]]>.

• Ampersand - zapisuj jako &amp;, ponieważ samotny znak może wywołać błąd parsowania.
• Znak mniejszości - zapisuj jako &lt;, gdy ma być zwykłym tekstem, a nie początkiem tagu.
• Znak większości - zapis &gt; jest przydatny w treści porównań i fragmentach kodu.
• Cudzysłów w atrybucie - w razie potrzeby użyj encji &quot;, aby nie zamknąć wartości atrybutu.
• CDATA - stosuj do większego tekstu technicznego, ale nie do ukrywania źle zaprojektowanej struktury danych.

Przykład CDATA: <opis><![CDATA[Porównanie: A < B, a kod zawiera <tag>]]></opis>. Jeśli opis ma być zwykłym zdaniem, lepszy jest normalny tekst z właściwymi encjami.

Samotny znak ampersand w tekście XML powoduje błąd składni, dlatego nazwę „A & B” zapisuje się jako „A &amp; B” zgodnie z regułami XML 1.0 W3C.

Jak walidować XML względem składni i schematu XSD?

Walidacja XML ma dwa poziomy: sprawdzenie well-formed XML wykrywa błędy składni, a walidacja względem XSD sprawdza zgodność z konkretnym wzorem danych. XML Schema i XSD 1.1 pozwalają określić dozwolone elementy, atrybuty oraz typy danych, takie jak tekst, liczba czy data (źródło: W3C, 2012).

Co oznacza well-formed XML?

Well-formed XML to dokument poprawny składniowo: ma jeden root element, domknięte tagi, właściwe zagnieżdżenie i poprawnie zapisane znaki specjalne. Taki plik może nadal nie przejść importu, jeśli nie spełnia firmowego schematu XSD.

Jak działa walidacja XML Schema?

Walidacja XSD porównuje plik XML z regułami schematu, na przykład sprawdza, czy element cena występuje obowiązkowo i czy zawiera liczbę. Pobieraj XSD tylko z dokumentacji systemu, który odbiera plik, a nie z przypadkowych forów.

• Zrób kopię pliku - przed zmianami skopiuj XML do folderu Kopie, aby nie utracić poprawnej wersji danych.
• Otwórz dokument w Visual Studio Code - edytor ułatwia policzenie wierszy i pokazuje niedomknięte tagi.
• Odczytaj linię oraz kolumnę błędu - komunikat parsera zwykle wskazuje miejsce, od którego trzeba zacząć kontrolę.
• Sprawdź tagi wokół błędu - porównaj nazwę otwierającą i zamykającą oraz ich kolejność.
• Uruchom walidację XSD - zastosuj ją wyłącznie wtedy, gdy importer dostarczył odpowiedni schemat.
• Wykonaj próbny import - najpierw użyj jednego rekordu, jeśli system pozwala testować dane bez publikacji.

„Parafraza: XML Schema definiuje dopuszczalną strukturę dokumentu XML oraz typy jego danych, więc sprawdza więcej niż samą składnię.” - W3C, XML Schema Definition Language (XSD) 1.1, 2012.

Jeżeli usługa zwraca komunikat „XML parsing error”, nie poprawiaj wszystkiego naraz. Zacznij od wskazanej linii, a następnie sprawdź poprzedni tag otwierający. Zobacz również, co to jest plik XSD, jeśli importer wymaga pliku schematu obok XML.

Najczęstsze błędy w XML i ich naprawa

Najczęstsze błędy w plikach XML to niedomknięty tag, niezgodne zagnieżdżenie, dwa elementy główne, samotny ampersand oraz zapis pliku jako .xml.txt. Każdy z tych problemów blokuje parsowanie albo import, ale zwykle da się go naprawić po sprawdzeniu komunikatu z numerem linii.

Dlaczego XML nie otwiera się poprawnie?

Najczęściej XML nie otwiera się poprawnie przez jeden błąd składni w konkretnej linii, na przykład brak </nazwa> albo zapis A & B bez encji. Przeglądarka albo walidator poda zwykle linię i kolumnę, lecz błąd może zaczynać się kilka znaków wcześniej.

Jak naprawić błąd wielu root elementów?

Umieść wszystkie rekordy w jednym wspólnym elemencie, na przykład <zamowienia>. Dwa osobne tagi główne obok siebie nie tworzą poprawnego dokumentu XML.

• Niedomknięty tag - dopisz brakujący tag zamykający z ukośnikiem i identyczną nazwą.
• Błędne zagnieżdżenie - zamknij najpierw ostatni otwarty element, a dopiero potem jego rodzica.
• Dwa korzenie - obejmij oba zestawy danych jednym tagiem głównym.
• Samotny ampersand - zamień każdy zwykły znak & w danych na &amp;.
• Złe rozszerzenie - pokaż rozszerzenia w Eksploratorze i zmień nazwę z plik.xml.txt na plik.xml.
• Niezgodne UTF-8 - zapisz plik ponownie jako UTF-8 albo popraw deklarację kodowania zgodnie z rzeczywistym zapisem.

Po każdej poprawce zapisz nową kopię, na przykład produkty-poprawione.xml. Nie nadpisuj pliku otrzymanego od kontrahenta, jeśli może być potrzebny do wyjaśnienia różnic w imporcie. Gdy potrzebujesz innego formatu do arkusza, sprawdź instrukcję jak przekonwertować XML na CSV.

Programy do tworzenia i otwierania XML

Program do tworzenia XML dobierz do wielkości pliku i celu pracy: Notepad wystarcza do kilku wierszy, Visual Studio Code pomaga przy większej strukturze, a przeglądarka służy głównie do szybkiego podglądu. Żaden z tych programów nie gwarantuje zgodności z konkretnym importerem bez jego XSD.

Jak otworzyć plik XML w Windows?

W Windows kliknij plik XML prawym przyciskiem myszy, wybierz Otwórz za pomocą i wskaż Notatnik, Visual Studio Code albo przeglądarkę. Przeglądarka pokaże strukturę, ale nie jest wygodnym narzędziem do bezpiecznej edycji.

Czy Visual Studio Code jest lepszy od Notatnika?

Tak, przy plikach mających kilkadziesiąt lub więcej wierszy Visual Studio Code jest wygodniejszy, bo koloruje tagi, ułatwia wcięcia i pokazuje numerację linii. Notepad pozostaje dobrym wyborem, gdy chcesz wykonać prostą poprawkę bez instalowania dodatkowego programu.

• Notepad - sprawdza się przy krótkim pliku XML i prostym zapisie UTF-8 w Windows.
• Visual Studio Code - pomaga znaleźć literówki dzięki kolorowaniu składni oraz numerom linii.
• Przeglądarka - szybko wyświetli błąd parsowania, lecz nie powinna być jedynym miejscem edycji.
• Walidator XSD - wybierz narzędzie wskazane przez dostawcę systemu, jeśli plik ma trafić do importu.

Bezpieczna zasada jest prosta: pobieraj edytory z oficjalnych stron Microsoft lub Visual Studio Code, a przed edycją pliku z danymi firmowymi wykonaj kopię zapasową. Więcej opcji opisuje poradnik jak otworzyć plik XML.

Najczęściej zadawane pytania

Jak utworzyć prosty plik XML?

Otwórz edytor tekstu, wpisz deklarację XML, dodaj jeden element główny i umieść w nim dane w zagnieżdżonych tagach. Zapisz dokument z końcówką .xml, wybierz UTF-8 i sprawdź, czy nazwy tagów są prawidłowo domknięte.

Czy XML musi mieć deklarację?

Nie, deklaracja XML nie jest bezwarunkowo wymagana w każdym dokumencie. Jest jednak zalecana, gdy plik zawiera polskie znaki albo ma być przekazany do innego systemu, ponieważ jawnie wskazuje wersję i kodowanie.

Czy w XML można używać polskich znaków?

Tak, polskie znaki działają poprawnie, gdy plik faktycznie zapisano w UTF-8 i deklaracja wskazuje encoding="UTF-8". Jeśli litery ą, ć lub ł wyświetlają się jako znaki zapytania, zapisz plik ponownie w UTF-8.

Dlaczego XML pokazuje XML parsing error?

Komunikat XML parsing error zwykle oznacza niedomknięty tag, nieprawidłowe zagnieżdżenie albo niezamieniony znak ampersand. Odczytaj numer linii i sprawdź tagi bezpośrednio przed wskazanym miejscem.

Jaka jest różnica między XML a JSON?

XML używa tagów, atrybutów i może korzystać ze schematów XSD, natomiast JSON zapisuje dane w parach klucz-wartość. JSON jest często krótszy w API, ale XML nadal występuje w plikach branżowych, konfiguracjach oraz systemach wymagających formalnego schematu.

Czy można pisać XML w Notatniku?

Tak, XML jest zwykłym plikiem tekstowym, więc Notepad wystarcza do jego utworzenia i poprawki. Przy większej liczbie elementów użyj Visual Studio Code, ponieważ szybciej zauważysz błędną strukturę XML.

Jak sprawdzić, czy XML jest poprawny?

Najpierw sprawdź, czy dokument jest well-formed: ma jeden element główny, domknięte tagi i poprawne znaki specjalne. Następnie użyj XSD dostarczonego przez odbiorcę pliku, jeśli importer wymaga konkretnej struktury.

Źródła i literatura

Specyfikacje XML i XSD

Poniższe dokumenty opisują składnię XML 1.0, reguły encji oraz walidację XML Schema. Stan dokumentacji sprawdzony: sierpień 2026.

• W3C - Extensible Markup Language (XML) 1.0 (Fifth Edition), 2008.
• W3C - XML Schema Definition Language (XSD) 1.1 Part 1: Structures, 2012.
• W3C - XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes, 2012.
• WHATWG - HTML Living Standard, dokumentacja parsowania i obsługi XML, dostęp sprawdzony w 2026 roku.