Task-oriented guides for accomplishing specific goals with Lutaml::Model.

XML serialization

• XML Serialization Mapping - Complete XML mapping reference

• XML Namespaces - Multi-namespace documents

• XML Namespace Qualification - Advanced control

• XML Mappings Guide - Complete XML reference

• XML Namespace Semantics - XML Namespace Semantics

• XML Namespace Presentation - XML Namespace Presentation

• Reusable Mapping Classes - Share mappings across models

Key-value serialization

• Custom Serialization Methods - with:/transform:, type-level serialization, of_* entry points

• Key-Value Serialization - JSON/YAML/TOML/Hash

• Collection Serialization - JSONL and YAML Stream

Advanced mapping

• Advanced Attribute Mapping - Same-name dispatch on attribute values (when_attribute), grouped declarations, custom methods, delegation

Performance

• Native engines (leptris / yeptris / teptris) - Drop-in XML/YAML/JSON/TOML engine upgrades via bundle opt-in

Linked Data serialization

• Unified RDF Serialization - One rdf block for both JSON-LD and Turtle

• JSON-LD Serialization - W3C JSON-LD 1.1 with @context

• Turtle Serialization - W3C RDF Turtle format

RDF infrastructure

See RDF Namespaces for namespace classes, NamespaceSet, Iri, and Literal value objects.

Advanced features

• Value Transformations - Transform values during serialization

• Missing Values Handling - Handle nil/empty/omitted

• Advanced Mapping - Custom methods and delegation

• Schema Generation - Generate schemas from models

• Creating XSD Schemas - Complete reference for XSD generation from LutaML models

• Schema Import - Import schemas to create models

• Liquid Templates - Template integration

• OOXML Examples - Real-world Office Open XML

• Consolidation Mapping - Group sibling elements into structured models

• Document Validation - Document-level validation with rules, profiles, and remediation

Runtime environments

• Opal Usage Guide - Run Lutaml::Model in the browser via Opal (Ruby to JavaScript)

By task

I want to serialize to XML

1. Start with XML Mapping basics

2. Add namespace support

3. Control qualification

I want to serialize to JSON/YAML

1. Key-Value Serialization guide

2. Transform values if needed

3. Handle nil/empty values

I want to serialize to JSON-LD or Turtle (Linked Data)

1. Unified RDF Serialization (recommended — one block for both formats)

2. JSON-LD Serialization guide (legacy jsonld do block)

3. Turtle Serialization guide (legacy turtle do block)

4. RDF Namespaces reference

I want to work with collections

1. Collection Serialization

2. Collections reference

3. Consolidation Mapping - Group elements into structured models

I want to transform data

1. Value Transformations guide

2. Advanced Mapping techniques

I want to generate or import schemas

1. Generate schemas (XSD, JSON Schema)

2. Import schemas to models

See also

• Tutorials - Step-by-step learning

• Core Topics - Reference documentation

• Reference - Technical details