protoml-parser/examples/feature-suite/README.md

ProtoML is a lightweight, declarative markup language designed for writing and structuring meeting protocols, notes and task lists in a human-readable and machine-parseable format.

# Feature Suite

This folder contains a compact ProtoML demo set that exercises the main parser features in one place.

Included files:

- `_priority_tags.pml`
- `_workflow_tags.pml`
- `main_demo.pml`
- `imported_section.pml`
- `snippet.html`

Suggested commands:

```bash
protoparser examples/feature-suite/main_demo.pml html
protoparser tags examples/feature-suite/_workflow_tags.pml statistics
protoparser analyze examples/feature-suite/main_demo.pml statistics
```

These two commands are enough to test the complete setup:

- `main_demo.pml` loads the imported `.pml`, the imported `.html`, shared tags, and macros
- the statistics command can also be run against `_priority_tags.pml` because the shared tag files are connected via `@tags_import`
- the analyze command shows the general cross-reference tree and local vs resolved stats for the main `.pml`

What this set covers:

- `@author`
- `@version`
- `@meta=key:value`
- `@protocol`
- `@meeting`
- `@participants`
- `@subjects`
- `@tasks`
- `@notes`
- `@signatures`
- `@approvals`
- `@references`
- `@attachments`
- `@tags`
- `@tags_import`
- `@tag_sources`
- `@title` in tag files
- local tag overrides
- nested shared tag files
- `@import ... html`
- `@import ... pml`
- `@@import` and `@@output`
- `@@ref`
- `@@toc`
- `@@signature`
- `@@approval`
- macro registration and usage
- inline references with `@@e=...`
- inline formatting