docs: document md-print usage

2026-10-23 11:01:16 +08:00
parent 4a19336445
commit 80da5364e5
3 changed files with 46 additions and 1 deletions
@@ -1,6 +1,6 @@
 ---
 name: tttk-authoring
-description: Author and edit TTRPG game design documents for the tttk (Tabletop Toolkit) CLI. Use when writing or modifying markdown content that uses tttk custom elements (:md-dice, :md-table, :md-deck, :md-pins, etc.), custom fenced code blocks (role=spark-table / declare / file / tag), companion CSV data files, or when previewing content with `tttk serve` and validating it with `tttk check`.
+description: Author and edit TTRPG game design documents for the tttk (Tabletop Toolkit) CLI. Use when writing or modifying markdown content that uses tttk custom elements (:md-dice, :md-table, :md-deck, :md-print, :md-pins, etc.), custom fenced code blocks (role=spark-table / declare / file / tag), companion CSV data files, or when previewing content with `tttk serve` and validating it with `tttk check`.
 ---

 # Authoring tttk game design documents
@@ -82,6 +82,9 @@ marker, and fence attribute keys may contain hyphens (e.g. `data-foo=bar`):
 - For card decks, use the `yaml role=tag` form with `tag: md-deck` (see
  `yaml-tag.md`). The `:md-deck[...]{...}` directive is legacy and can't express
  template layers or card backs.
+- To print a rules document, use `:md-print[./rules.md]` (or the `yaml role=tag`
+  form). It paginates into A4 landscape sheets holding two A5 pages, each with
+  `columns` columns (default 2). See `reference.md` for the attributes.
 - Keep CSV files clean — header row plus data. Put deck config and templates in
  the YAML block's `data-config`, not in CSV front matter (see `csv.md`).
 - `{{prop}}` in a CSV `body` interpolates another column (or front-matter key)