Legal Contract

What it demonstrates: A formal legal document using :sectnums: for automatic multi-level legal numbering (1. / 1.1 / (a) / (i)), description lists for definitions, and sections that opt out of numbering for the Parties, Background, and Execution clauses.

Who it’s for: Users producing contracts, agreements, or other legal documents where structured numbering is essential.

Run It

ascii2doc --theme examples/legal/legal-theme.yml examples/legal/contract.adoc
open examples/legal/contract.docx

Source Files

examples/legal/contract.adoc — the contract content
examples/legal/legal-theme.yml — conservative legal theme

How Legal Numbering Works

Notice how :sectnums: and :!sectnums: toggle numbering on and off. Sections before :sectnums: (Parties, Background) and after :!sectnums: (Execution) remain unnumbered:

= Software Licence Agreement
:doctype: article
:toc:
// -- Parties --
:licensor-name: Acme Software Pty Ltd
:licensor-acn: 000 000 000
:licensor-address: 123 Collins Street, Melbourne VIC 3000
:licensee-name: The party identified in the Order Form
:licensee-acn: 111 222 333
:licensee-address: 456 George Street, Sydney NSW 2000
// -- Agreement details --
:agreement-date: 1 January 2025
:payment-days: 30
:interest-rate: 2%
:liability-period: 12 months

[discrete]
== Parties

This Agreement is entered into as of {agreement-date} between: