跳到主要內容

Live guide · ARC 2.0.0-beta.32

Write tables and callouts in Markdown

Place GFM tables and GitHub-style callouts in a Web Device content item, then inspect their actual rendered output on the same page.

The Web Device content reader turns GFM tables and GitHub-style callouts in Markdown into document content. The source and result below use the same document-reading path. They are not a general AUP table or text primitive contract, and they do not imply that format: markdown inside an AUP page has the same result.

This page is a live feature guide. Unit pages: gfm-table, gfm-admonition.

Sample contract

FieldValue
PurposeAuthor static GFM tables and admonition callouts in content Markdown
BoundariesNot an editable grid; not AUP table node; not a chart fallback table; no write path
Author entryPipe tables · > [!NOTE]-style blockquotes in content.md
SurfaceWeb Device document (static)
Public statusreleased
Fallback / failureUnknown admonition marker → ordinary blockquote; bare marker uses locale default title
VerificationRoutes below · arc --version = 2.0.0-beta.32

A GFM table

Source:

markdown
| File | Purpose | Writes data |
| --- | --- | --- |
| `content.md` | Content item | No |
| `layout.aup` | Page layout | No |

Rendered:

FilePurposeWrites data
content.mdContent itemNo
layout.aupPage layoutNo

This is a Markdown table handled by the content reader (often as HTML text in the document tree). It does not turn the table into editable data, establish an AFS data source, or prove the AUP primitive table path. Do not confuse an empty chart degradation table (No data / reshape) with this author-written GFM table.

Failure and limits

SituationExpected result
Malformed pipesOrdinary Markdown / broken table, not a runtime error surface
Empty body rowsAuthor content only — no automatic “No data” chrome from the chart chain
Assuming AUP table propsWrong surface; write AUP JSON/DSL when you need that node

A GitHub-style callout

Source (custom title on the marker line):

markdown
> [!IMPORTANT] This is a content-file capability
> Write this kind of callout in `content.md`. The page presents what the author wrote; it does not execute an action or modify data.

Rendered:

This is a content-file capability

Write this kind of callout in content.md. The page presents what the author wrote; it does not execute an action or modify data.

Bare markers (no same-line title) use the reader’s default label for the content locale. English keeps the English defaults from the text renderer; zh defaults are applied at read time:

Markerzh default title
NOTE说明
TIP提示
IMPORTANT重要
WARNING警告
CAUTION注意

An explicit same-line title always wins over the locale default, in any locale.

Source (bare marker — label comes from locale defaults):

markdown
> [!TIP]
> Prefer a same-line custom title when the English word is not the label you want.

Rendered:

Tip

Prefer a same-line custom title when the English word is not the label you want.

The current reader recognizes five markers: NOTE, TIP, IMPORTANT, WARNING, and CAUTION (case-insensitive). An unknown marker remains an ordinary blockquote instead of becoming a different callout.

Failure and limits

SituationExpected result
[!FIXME] or other unknown markerPlain blockquote, not a callout chrome
Marker not on the first line of the quoteNot recognized as admonition
Expecting an editor or dismiss controlStatic document content only

GFM tables and callouts in content items are static document content. To author a runtime AUP tree, keep this document-reading path separate from the target-specific primitive support that its renderer defines. For the site-facing boundary, see AUP layout boundary.

Verification evidence

ItemValue
Baseline2026-08-12 · arc --version2.0.0-beta.32
Capability rowdocs/aup/capability-matrix.md (internal, non-routed) · GFM admonition · GFM table
Implementationproviders/runtime/web-device/src/content-reader.ts (ADMONITION_MARKER_RE, ADMONITION_LOCALIZED_LABELS); text admonition renderer
Unit pagesgfm-table · gfm-admonition
Public routes/en/docs/web-device/markdown-gfm-callouts/ · /zh/docs/web-device/markdown-gfm-callouts/
Local runarc service start --blocklet blocklets/arcblock --port 4900 · open routes; on zh locale, bare markers show Chinese default titles
AcceptSource and rendered table/callout match; unknown marker stays a quote; no edit controls