Get Started with Metanorma
Prefer a guided course? The Learn Metanorma tutorial walks through the same steps — and more — lesson by lesson.
1. Install Metanorma
The fastest way to get started is with Docker:
docker pull metanorma/metanorma
For native installation and other options, see the Installation Guide.
2. Write your first document
Create a file called my-standard.adoc:
= My First Standard
Author Name
== Introduction
This is my first Metanorma document.
== Scope
This document covers ...
3. Compile
Compile to HTML and PDF:
metanorma compile -t iso -x html,pdf my-standard.adoc
This produces my-standard.html and my-standard.pdf.
4. Choose your flavor
The -t flag selects the target standards organization (the “flavor”). Common flavors include:
iso— ISO standards (ISO quick-start sample)iec— IEC standards (IEC quick-start sample)ietf— IETF RFCs and Internet-Drafts (IETF quick-start sample)ieee— IEEE standards (IEEE quick-start sample)ogc— Open Geospatial Consortium (OGC quick-start sample)
See the flavors page for the complete list.
Next steps
- Authoring Guide — Learn the Metanorma authoring syntax
- Installation Guide — Detailed setup for all platforms
- Developer Docs — Building on top of Metanorma