An open, vendor-neutral file format for commercial real-estate underwriting. One readable file keeps the narrative, deal data, calculations, validation, and provenance together.
UW Markdown is a plain-text standard for commercial real-estate underwriting. The file extension is .uw.md. Read it in any text editor, track it in Git, validate it with the reference tools, export it to Excel, or give the same file to an AI system without translating the deal into another format.
llms.txt. An optional MCP binding profile is documented, but no connector is required.A .uw.md document combines ordinary Markdown with labeled JSON blocks. The Markdown explains the deal to a person. The JSON gives software stable fields. Deterministic calculation packs compute values such as NOI, DSCR, LTV, debt yield, and IRR. AI may extract facts and write narrative, but it does not perform the financial math.
Files retain their history: updates supersede earlier blocks instead of erasing them, and provenance records who or what made each change.
The downloads page has blank screener and analyst templates, a single-file browser viewer, complete example deals, source packages, and small instruction files for Codex, Claude, ChatGPT, and Gemini. Everything is plain text or a static file; there is no account or hosted connector to configure.
The TypeScript reference implementation includes a parser, validator, byte-preserving editor, deterministic calculation engine, format converters, CLI, Excel export, report rendering, and reference HTTP/MCP adapter shapes.
npx uwmd init my-deal.uw.md
npx uwmd validate my-deal.uw.md
npx uwmd summary my-deal.uw.mdBrowse the repository, compare the available tools, or read the developer architecture.
The specification, schemas, fixtures, and reference implementation are public under the MIT License. Normative changes use an open RFC process, and implementations can test themselves against published conformance tiers.
Read the specification · See the roadmap · Contribute on GitHub