ProtoML

By OpenDucks IT

GitHub

ProtoML – A semantic markup for protocols

ProtoML is a minimal, human-readable markup language to describe structured protocols, meetings, task lists and notes. Its simplicity and machine-readability makes it ideal for digital documentation pipelines.

🧠 Why ProtoML?

• 💡 Declarative & clean – No logic, no magic
• 📄 Structured – Generate HTML, JSON, PDF
• 🔗 Referencable – Use IDs, cross-links and macros
• 🧩 Extensible – Import tags, external blocks, themes
• 🎯 Perfect for teams, protocols, meeting minutes

🔍 Syntax Example

@date:21.05.2025
@participants
=pt1:John Doe,jdoe,jdoe@example.com
=pt2:Jane Doe

@subjects
=0:TimeTrack Update

@tasks
-[ ] Update TLS certificate =0 @ptp=pt1 @tag=important

@meeting
# Agenda: @@e=0
@@e=pt1, @@e=pt2

🚀 Getting Started

Use protoparser to convert .pml files to HTML, JSON or PDF:

npm install -g protoml-parser
protoparser protocol.pml html

🛠️ Output Formats

• HTML – Printable, styled exports
• JSON – For structured data pipelines
• PDF – Export to PDF
• Markdown – Planned for v1.1

📦 Project Info

Find the parser on GitHub or contact us for integrations into existing systems or Electron apps.

💬 What ProtoML is not

• Not a full Markdown replacement
• No runtime, no loops, no variables
• No embedded logic – just structured content

✨ Designed by OpenDucks IT

ProtoML is part of our mission to build human-friendly tools for documentation, governance and transparency – used in NGOs, education and open-source teams.