Executable Legal Writing.

Neon Law Notations are a way to write legal agreements in markdown, and specify data and workflows in frontmatter. Our Navigator CLI helps authors adhere to rules, ground with our ontology, and deliver excellent legal product.

Explore the templates ↗Follow the format ↓
agreement.md
---
kind: agreement
title: Sample agreement
prompts:
  delivery: How should notices arrive?
choices:
  delivery:
    email: By email
    post: By post
questionnaire:
  BEGIN: { _: custom_single_choice__delivery }
  custom_single_choice__delivery: { _: END }
  END: {}
# … workflow and other metadata
---

## I. Notices

Delivery method: {{custom_single_choice__delivery}}.
YAML Frontmatter+Markdown body

Many sources. One working format.

Markdown in the middle.

Email, conversations, questionnaires, and documents supply the material. A lawyer confirms the facts and scope. Notation brings the text and its structure together so the work can be read, checked, revised, and rendered.

  • Conversations

    Email, text messages, and discussions supply facts for confirmation.

  • Questionnaires

    Typed questions gather the answers a template needs.

  • Word documents

    Managed import projects supported document structure into notation.

  • Markdown templates

    Authored prose and Frontmatter declare the document and its process.

Notation pen

Computable legal format

Markdown + Frontmatter

  • Word revisions

    Supported edits return to the original package with tracked changes.

  • Typst

    The Typst rendering engine typesets Markdown into PDFs, with the document's layout, headings, and page numbering.

  • Government forms

    Declared field mappings fill the issuing agency's PDF.

  • Browser previews

    Read the document and explore its questionnaire before running it.

One file. Four connected parts.

A template is the blueprint. Bind it to a respondent and a Project, and it becomes a running Notation with answers, review, and a history.

  • Metadata

    Frontmatter names the document and the rules that govern its structure.

  • Questionnaire

    Typed questions collect answers. Prompts supply wording; choices name the available options.

  • Workflow

    Explicit steps describe how the work advances and where a lawyer makes the decision.

  • Body

    Readable prose carries headings, clauses, and placeholders that resolve from the answers.

Plain text. Precise checks.

Navigator's Rust rule engine checks declared kinds, required fields, question types, placeholders, and workflow structure. The CLI and editor use the same rules.

  • Check the project

    navigator project gate validates the repository's Markdown, YAML, and notation contracts together.

    Read the rule reference

  • Preview a file

    navigator notations preview opens a local browser preview of a template and its questionnaire.

    Learn to author a notation

  • Walk the questions

    navigator notations run exercises a template in a temporary local store with synthetic identities so you can inspect its transitions.

    Understand the runtime

  • Check as you type

    navigator-lsp shows diagnostics and hover explanations in your editor, using the rule engine behind the CLI.

    Read the Frontmatter guide

Explore the templates