UW Lite and UWX

UW Markdown supports two complementary Markdown files. Both are current representations with their own specifications.

• .uwx.md — UWX is the complete structured underwriting record. It carries the full section model, append-only provenance, detailed assumptions, calc inputs, and the structured editor workflow.
• .uw.md — UW Lite is a compact, readable deal summary for simple hand authoring, review, and dependable machine extraction through explicit uw: field anchors.

Use Lite when a person needs a lean, familiar-looking underwriting summary. Use UWX as the working record whenever the deal needs full structured underwriting.

Open either file in the editor

The reference editor accepts both files. Opening Lite compiles the supported deal-summary fields into UWX and then uses the normal structured editor. The compilation bar shows the mapped fields and deterministic defaults, while the complete Lite source is retained inside the UWX file as a namespaced provenance extension.

The compiler rejects unsupported units, period-qualified values, non-base scenarios, and unknown fields. It does not infer financial values.

Exporting back to Lite

Choose Export Lite in the editor or run:

uwmd convert deal.uwx.md --to lite --projection-report deal.lite-projection.json

Lite is deliberately a smaller deal-summary profile. If an UWX record contains data outside that profile, the editor shows the number and exact omitted paths before export; the CLI writes the same machine-readable report with --projection-report.

That warning is intentional: a Lite export is a readable summary, not a replacement for the complete UWX record. Keep the .uwx.md file with the export whenever the projection is lossy.

Command-line conversion

# Compile a Lite summary into the complete structured representation
uwmd convert broker-summary.uw.md --to uwx

# Create a readable Lite summary from a UWX record
uwmd convert underwriting.uwx.md --to lite --projection-report lite-loss.json

A .uw.md file is Lite. Structured content (uw:section JSON fences) under that extension is refused as SOURCE_CONTENT_MISMATCH, whatever representation the caller names; structured records use .uwx.md.

Lite frontmatter declares both uw_lite_version: 1.0 and the supported string uw_version: "3.0". Parsing, compilation and receipt verification refuse an absent or unsupported rule-set declaration.

A minimal Lite field

- Purchase price: $12,500,000 <!-- uw:acquisition.purchase_price -->

The visible text stays easy to read. The anchor provides the stable machine field path, while the parser normalizes the currency value deterministically. See the UW Lite specification for the complete grammar and supported bridge profile.