.gram syntax

이 상세 자료는 아직 한국어로 번역되지 않아 영문 원문을 표시합니다.

GA 공개 출처와 지원 범위

Status: GA
Component: .gram format / Gram Core
Deployment: n/a (format spec)
Applies to version: Latest
출처 확인일: 2026-10-25
Owner: thegram-one/thegram-format
Public evidence: thegram.one/gram-file/
Basis: The public .gram overview documents the plain-text file format and its retained history; no separate syntax-spec release version was found.

출처 확인은 실제 계정 설치·기기 동작·서비스 상태의 검증을 뜻하지 않습니다.

Current source

A current document begins with @gram 2, a doc <id> owner, and zero or more typed records. Current writer files end in a Core-owned @gram-history 6 trailer. The trailer is not authored article content.

@gram 1 remains a readable legacy source version; it is not the current writer format. IDs are stable document-local identifiers using letters, digits, hyphens or underscores. A record begins with a type code and ID, such as K local-search or T review-index. IDs are not derived from titles.

Fields and values

A field is one line: key value. The value is the rest of that line and remains text; the format does not coerce a date, number, status or color. Common keys include t (title), d (description), x (status), s (scope), p (priority), owner, tag, source, ref, view and motion. t is required on the document and known records. Singleton fields cannot repeat; tag and source may repeat.

Blocks

A literal block starts with ::kind and ends at a line exactly equal to ::end. Payload is data, not executable code; block bodies do not nest. Unknown block kinds are retained. When a payload line itself equals ::end, escape it as \::end; the reader removes the escape.

Minimal valid source

@gram 2
doc index-notes
t Index notes
K lookup
t Keep query boundaries explicit
::reason
The index is a derived view, not canonical document content.
\\\\\\::end
An escaped terminator line remains literal payload.
::end

A payload line equal to a terminator must be escaped, and the block still needs its own closing ::end.

See Records for type/field conventions and Relations for edge direction. Source grammar and validation are defined by the linked Core format specification.

Source

Source: .gram language specification

Reference: https://github.com/clab-one/thegram-format/blob/main/spec/language.md

Source: Current rich document specification

Reference: https://github.com/clab-one/thegram-format/blob/main/spec/rich-document.md

Source: Current History/6 specification

Reference: https://github.com/clab-one/thegram-format/blob/main/spec/source-history-render.md

Source and renderer evidence

Canonical source SHA-256: 8443977830c651d7784d91bdd61fee6ae2f76935a85554b60d90bc35221d532f
Selected revision: r5 · sha256:ea389f0d8defd071208f4d889781a58995aa696f15680ea28652a2928d9a0394
Local renderer: configured local Thegram renderer · API thegram-web-render/1
Core source: git+https://github.com/clab-one/thegram-format.git?rev=b16489e1d0d77d38f82d2f61776524737aa31557#b16489e1d0d77d38f82d2f61776524737aa31557

Canonical source: syntax-guide.gram

안내와 다른 점이 있나요? 문서 오류 신고 · 문제 해결
이메일은 직접 검토해 전송하세요. API key나 비공개 문서 내용은 보내지 마세요.