Recently Visited
Recently Visited

Orion API - Text Document Format

[VERIFIED] Last updated by Joe Schaefer on Fri, 12 Jun 2026    source
 

Text Document Format (markdown, YAML, CSV)

This page documents the Header fields and resulting Data Artifacts produced by the Build API when processing such text files (as page attachments) via its single_narrative view.


Markdown

Headers

title

Mandatory document title.

status

Mandatory free-text document status.

Three such special status labels are explained below:

draft

Default state.


verified

Indicates that content has been validated by the author. Will roll back to draft state if document is subsequently altered without revalidation.


archived

Indicates document is finalized and ignorable for future work in the Orion CMS. Will not appear in future directory listings outside of its archived location. Archived location will track future content modifications.

acl

Optional SVN security authorization controls on this document. With autocomplete support and group validation in the Orion CMS editor.

dependencies

Optional comma-separated list of file globs that this document’s built output relies upon.

keywords

Optional SEO-friendly comma-separated list of searchable tags.

categories

Optional comma-separated list of classification categories that should reference this permalinked document.

Additive in nature (removing categories will not cause those ex-categories to delist this document).

Data Artifacts

n/a

GFM Extensions

[TOC]#sidebar

Automatic Table of Contexts with optional id=sidebar on the enclosing <div>.

#sidebar enables dynamic behavior in the left sidebar for screens possessing more than 1900px width.

[^name] Footnotes

Automatic Footnotes.

Bidirectional links between referenced footnotes and their descriptions.

fenced block extensions

mermaid

Markdown @mermaidjs/mermaid diagrams.

asy

Asymptote Vector Graphics iframe renderer.

dot

d3-graphviz dot renderer.

[snippet:…]

Download and inject code snippets from public git repos like GitHub.


YAML

Headers

title

See markdown section above.

status

See markdown section above.

acl

See markdown section above.

Data Artifacts

content

YAML::XS::Load parsed data structure


CSV

Headers

title

See markdown section above.

status

See markdown section above.

acl

See markdown section above.

headers

Optional; true value indicates that this document has a CSV header line at the top of its content.

column_ids

Optional comma-separated list of Column Ids for PDL

datetime

Optional strptime(3) format for PDL processing

type

Optional declared PDL column data types

Data Artifacts

content

arrayref of either arrayrefs (no csv headers), or hashrefs (csv headers)

csv

Text::CSV object used to produce above

csv_headers

arrayref of original (unmunged) headers

pdl

Full PDL object generated by header configuration