> For the complete documentation index, see [llms.txt](https://vans-studio.gitbook.io/xvml/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vans-studio.gitbook.io/xvml/vvedenie.md).

# Введение

## Документация XVML

### Введение

XVML — это лёгкий и гибкий парсер файлов с расширением `.xvml`, созданный для использования в проектах на C# и Unity. Он сочетает XML-подобную структуру с удобством работы с JSON-подобным содержимым — **SoftJSON**.

XVML разработан с целью:

* Обеспечить удобный и безопасный способ хранения данных.
* Быть устойчивым к мелким ошибкам формата (отсутствие кавычек, запятых, двоеточий).
* Поддерживать и C#-проекты, и Unity (через .NET Standard 2.1).
* Позволять легко работать с вложенными структурами данных.
* Иметь минимальные зависимости и простую интеграцию.

#### Особенности XVML

1. **Поддержка SoftJSON** — содержимое тегов может быть как валидным JSON, так и «мягким» lenient JSON. Используется автоматическая нормализация.
2. **Гибкая структура тегов** — теги поддерживают атрибуты, вложенные элементы, текстовый контент.
3. **Устойчивость к ошибкам** — парсер не падает из-за частично повреждённых данных.
4. **Кроссплатформенность** — поддерживаются .NET 8/9 и Unity.
5. **Лёгкая интеграция** — доступен в NuGet и как DLL.
6. **Поддержка самозакрывающихся тегов** — `<tag/>` и `<tag />`.
7. **Поддержка include** — можно подключать другие файлы: `<include file="path.xvml" />`.

#### Установка

XVML доступен через NuGet:

[Установить XVML через NuGet](https://www.nuget.org/packages/XVML/)