Skip to content

Quillmark Format

Quillmark is the document format used by TongueToQuill. It's standard markdown with structured metadata blocks — readable as plain text, but parseable as structured data.

Document Structure

Every document has two parts: a metadata block and a body.

---
QUILL: usaf_memo:0.1
memo_for:
  - 123 FW/CC
subject: Example Memo
---

1. This is the body. Standard markdown goes here.

2. Second paragraph.

Metadata Blocks

Delimited by --- on their own line. Content inside is YAML.

  • QUILL specifies the template and version (e.g., usaf_memo:0.1)
  • Other fields depend on the template (recipient, subject, signature block, etc.)
  • The --- delimiter is reserved for metadata — it never renders as a horizontal rule

Body Content

Everything after the closing --- is the body. Standard markdown: paragraphs, bold, italic, underline, lists, links, and code.

Cards

Documents can contain multiple sections called cards. Each card has its own metadata block with a CARD key:

---
QUILL: usaf_memo:0.1
subject: Main Document
---

Main body content.

---
CARD: indorsement
approver: Col Smith
---

Indorsement body content.

Cards enable multi-section documents like indorsements, attachments, and enclosures.

Supported Markdown

Feature Syntax
Bold **text**
Italic *text*
Underline __text__
Strikethrough ~~text~~
Headings # Heading (ATX-style only)
Ordered list 1. item
Unordered list - item
Links [text](url)
Inline code `code`
Code blocks ```
Comments <!-- comment -->

Not supported: images, tables, blockquotes, footnotes, raw HTML (except comments).

Placeholders

Use {:placeholder text:} to mark fillable fields in the body. These render as interactive elements in the editor — click to select, type to replace.

Unfilled placeholders convert to «placeholder text» in the exported PDF.

1. {:Describe the purpose of this memorandum:}

2. POC for this action is {:Name, Rank, Phone:}.