Skip to content
chiltepin
chiltepin docs
Blocks reference

Tables & code

When to use each of the 5 tables & code blocks, with a live example of every one.

Choose a tables & code block below and edit its starter example. In a Markdown document, use the block type as the fence language and the example as its body. Run chiltepin block <type> with your installed CLI for fields and allowed values. See installation for command setup or browse the visual catalog. Descriptions come from the authoring skill.

Shape: Grid — two axes of exact values (table, benchmark) — plus Structure & emphasis for headline numbers, targets, and code as evidence (stats, slo, code). Answers: What are the exact values? How big, fast, or reliable is it, as measured? Not this family — a table with a job has its own block:

  • cells are permission levels → matrix (business.md)
  • a value grid read by intensity → heatmap (charts-overviews.md)
  • the numbers move over time → chart (charts-overviews.md)
  • scores you invented rather than measured → scorecard or harvey (business.md)
  • a status per row → statustable (planning.md); components with a maturity → inventory (design-system.md)
  • term — definition → glossary; releases → changelog; findings with evidence → audit; a standard applied → checklist (quality.md)
  • touchpoints per stage → journey; API params / responses → endpoint

Tables & metrics

table — comparison table

Rows × columns of exact values; a cell can carry a tone and emphasis. Answers: what are the exact values? table, not matrix, when cells are data rather than permissions; not heatmap when the reader needs the numbers rather than the pattern.

```tableeditable · live
renderedchiltepin renders this
SECTION 01 · Comparison
FieldDescription
nameDisplay name
idStable identifier
Valid — passes chiltepin check

stats — KPI / metric cards

A row of cards: value, label, delta, and a trend arrow. Answers: how big is it right now? stats for a few KPIs with trends; bignumber for one hero number; chart when the numbers move over time; envelope for an estimate.

```statseditable · live
renderedchiltepin renders this
SECTION 01 · Metrics

This quarter

12.4k
Active users
▲ +18%
99.95%
Uptime
— 0
142ms
p95 latency
▲ -22ms
Valid — passes chiltepin check

slo — service-level objectives with error budgets

One row-card per objective: SLI, target, current, window, and a burn bar. Answers: are we inside the error budget? budget is the fraction consumed (0–1): the bar turns amber past 0.5, red past 0.8, "exhausted" at 1. Omit it to skip the bar. slo for reliability targets; okr for goals; stats for plain KPIs.

```sloeditable · live
renderedchiltepin renders this
SECTION 01 · Service objectives

Orders API — objectives

Availability30d

Successful requests / total requests

Target99.9%
Current99.97%
25% of error budget used
Latency30d

Requests served under 400 ms (p99)

Target99%
Current98.9%
70% of error budget used
Valid — passes chiltepin check

benchmark — measured results, side by side

Subject columns × metric rows; the best cell per row is derived from the numbers and highlighted. Never bold a winner yourself. better: low flips a row (latency, cost); better: none turns the highlight off; best: true forces it for a tie. variants on a row stacks one value per condition and compares each condition on its own line. Answers: what did we measure? benchmark for measured numbers; scorecard or harvey for scores you gave.

```benchmarkeditable · live
renderedchiltepin renders this
SECTION 01 · Benchmark

Retrieval engines, measured

BenchmarkOursv2.1Vendor AVendor B
Answer accuracyinternal QA set
82.4%
79.1%
74.8%
p95 latency500 rps soak
310 ms
420 ms
290 ms
Cost per 1k queries
$0.14cached
$0.90cold
$0.21cached
$1.10cold
$0.18cached
—

Single region, same corpus, October run.

Valid — passes chiltepin check

code — code the reader will copy or diff

When the reader will copy or diff it, it is a code block, not prose or a table; when the change is the point, kind: compare or kind: diff. highlight: "3-5, 8" bands the lines that matter; lines: true numbers them; cols: 2 sets snippets side by side (request / response); kind: compare is before / after under eyebrows; kind: terminal is a session. lang: text for prompts and plain notes (no highlighting); lang: markdown for Markdown source. steps for a runbook with prose between commands; gallery for a card grid.

```codeeditable · live
renderedchiltepin renders this
SECTION 01 · Code
add.tsTypeScript
export function add(a: number, b: number): number {
  return a + b;
}
add.test.ts
expect(add(2, 2)).toBe(4);
Valid — passes chiltepin check