STXT: Introduction

Documents

An STXT document is a structured text file, designed to be human-readable and easy for machines to process. It contains "nodes": non-empty lines (outside of >> blocks) that define "Name" and value pairs, or literal text blocks.

Main features

• Inline/container nodes: Name: Value (can have indented children).
• Text blocks: Name >> followed by literal lines that are not parsed internally.
• Hierarchy is defined by indentation (tabs or 4 spaces per level depending on the document).
• Supports namespaces (e.g. (@com.example)), comments outside blocks (# ...), and validation via schemas (@stxt.schema).

An STXT document balances human clarity with explicit semantic structure — ideal for content, configurations, and interoperable data.

Email:
	From: John Smith
	To: Mery Adams
	Cc: Keyla Brown
	Title: Project report
	Body Content >>
		Hello Mery!
		The book is finished!

Namespaced documents

STXT allows the use of namespaces, to give meaning and structure to the content.

Email (com.example.docs):
	From: John Smith
	To: Mery Adams
	Cc: Keyla Brown
	Title: Project report
	Body Content >>
		Hello Mery!!
		The book is finished!!

And the namespace definition

Schema (@stxt.schema):
	Namespace: com.example.docs
	Node: Email
		Childs >>
			From
			To
			Cc
			Bcc
			Title
			Body Content
	Node: From
	Node: To
	Node: Cc
	Node: Bcc
	Node: Title
	Node: Body Content
		Type: TEXT