Published tables next to four converted versions

The five test pages from the Docs WG lead, table by table. First: the page as published on docs.cloudfoundry.org today. Then the same table built with Docusaurus, Zensical, Starlight, and Antora in the mode you pick. All are screenshots at a 1280-pixel browser window with each tool’s default theme; colors and fonts belong to the theme and are not compared. Under Size, Fit shrinks each screenshot to its column and Actual size shows it pixel for pixel in a box that scrolls sideways and down. Click a screenshot to open it full size, or hide tools under Show to make the rest larger.

What the converted pages leave out or change, outside the tables

A word-by-word comparison of each page’s main text against the published page, in every mode. The tables themselves match apart from the decided fixes (backslashes removed, title moved above the table).

DifferenceDocusaurusZensicalStarlightAntora
Accept: */* in terminal output (troubleshooting)shows as Accept: /: MDX reads */* as emphasiskeptshows as Accept: /, as in Docusauruskept (the block stays raw HTML)
Terminal blocks (<pre class="terminal">)split into paragraphs inside the blockone block inside a list item split into paragraphs; no characters lostone block loses a blank line and its indentationunchanged
Other prosematchesthree literal *: a list right after a text line, with no blank line, stays textmatches, after the passthrough rewrites (without them spaces are lost: “passwordrefers”)matches, after the page is rewritten as AsciiDoc
Quotesstraight (published: curly)straightstraightcurly in AsciiDoc text, straight inside HTML blocks
“Page last updated” line and GitHub linknot reproduced by any site; each tool has options for them, these test sites leave them off
Section links at the top of the pagemoved to each theme’s own “On this page” list
Scale tableshown in a small host page, not in the rest of high-availability (by design)
Mode
Show
Size
Wide tables

_oss_scale_table

docs-cloudfoundry-concepts · partial included by high-availability · published page · 1 table

Table 1 Component / Total Instances / Notes

Source widths 25/25/50. In extension the key column stays on one line up to a 16em cap, so “Cloud Controller Worker” widens it (Docusaurus 30/24/46, Zensical 26/25/49, Starlight 31/24/45; in Antora it fits at 25%). Zensical, Starlight, and Antora native carry the widths. Plain pipe tables size columns by content; plain AsciiDoc tables make them equal. Passthrough adds class="table": every HTML table names its style. This table on the published page.

Published docs.cloudfoundry.org
Published _oss_scale_table table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1

credential-types

docs-credhub · published page · 1 table

Table 1 Type / Description

The published page never applied its table class: the source wrote it with curly quotes. The quotes are made straight, so class="table" names the standard style, as on every HTML table (decided). Column 1 is 20% wide. Extension adds row headers. This table on the published page.

Published docs.cloudfoundry.org
Published credential-types table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1

metadata

docs-cf-admin · published page · 3 tables

Table 1 Label requirements

Title: passthrough keeps the source’s spanning row; every other mode shows it as a bold line above the table, because Markdown tables have one header row (decided). The stray backslashes in \[a-z0-9A-Z\] are removed in every mode. Pipe tables hold the lists as inline HTML. This table on the published page.

Published docs.cloudfoundry.org
Published metadata table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1

Table 2 Annotation requirements

Same shape and decisions as the label table. This table on the published page.

Published docs.cloudfoundry.org
Published metadata table 2
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 2
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 2
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 2
Antora 3.2.1 passthrough
Antora 3.2.1 table 2

Table 3 Selector requirement reference

Already a Markdown table in the source. Extension adds row headers and roles; Antora native already has row headers (its cols marks column 1 with h). This table on the published page.

Published docs.cloudfoundry.org
Published metadata table 3
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 3
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 3
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 3
Antora 3.2.1 passthrough
Antora 3.2.1 table 3

troubleshooting_slow_requests

docs-cf-admin · published page · 6 tables

Table 1 Experiment 1: total round-trip requests

Passthrough carries each table’s widths as written; every other mode uses no widths and lets the column roles decide (variant C, decided). This table sets no widths in the source. This table on the published page.

Published docs.cloudfoundry.org
Published troubleshooting_slow_requests table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1

Table 2 Experiment 2: request time in access logs

Sits inside step 4 of a numbered list, so it is narrower. The source sets a width on column 1 only. This table on the published page.

Published docs.cloudfoundry.org
Published troubleshooting_slow_requests table 2
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 2
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 2
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 2
Antora 3.2.1 passthrough
Antora 3.2.1 table 2

Table 3 Experiment 3: duplicate latency

The source sets a width on column 1 only. This table on the published page.

Published docs.cloudfoundry.org
Published troubleshooting_slow_requests table 3
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 3
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 3
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 3
Antora 3.2.1 passthrough
Antora 3.2.1 table 3

Table 4 Experiment 4: remove the load balancer

The source sets a width on column 1 only. This table on the published page.

Published docs.cloudfoundry.org
Published troubleshooting_slow_requests table 4
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 4
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 4
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 4
Antora 3.2.1 passthrough
Antora 3.2.1 table 4

Table 5 Experiment 5: remove Gorouter

The source sets widths on columns 1 and 2. This table on the published page.

Published docs.cloudfoundry.org
Published troubleshooting_slow_requests table 5
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 5
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 5
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 5
Antora 3.2.1 passthrough
Antora 3.2.1 table 5

Table 6 Experiment 6: network between router and app

The source sets widths on columns 1 and 2. This table on the published page.

Published docs.cloudfoundry.org
Published troubleshooting_slow_requests table 6
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 6
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 6
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 6
Antora 3.2.1 passthrough
Antora 3.2.1 table 6

uaa-concepts

docs-uaa · published page · 2 tables

Table 1 Grant type / User / Details

The implicit row ended with </td> instead of </tr>; it is fixed. Column 1 is 30% wide wherever the mode carries widths. Without widths, columns are sized by content or made equal: column 1 is 27% in Docusaurus native, 16% in Zensical native-plain, 27% in Starlight native-plain and 33% in Antora native-plain. Its identifiers do not break. This table on the published page.

Published docs.cloudfoundry.org
Published uaa-concepts table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1

Table 2 Key / Value

In the allowed providers row, <br/><br/> is a paragraph break (decided): two paragraphs in extension, in Starlight native, and in Antora native and native-plain; passthrough and pipe tables keep the breaks. This table on the published page.

Published docs.cloudfoundry.org
Published uaa-concepts table 2
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 2
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 2
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 2
Antora 3.2.1 passthrough
Antora 3.2.1 table 2

uaa-performance

docs-running-cf · first section only; added after the round · published page · 1 table

Table 1 Instances / Threads / Throughput

The example of a second table style, table-media: no cell borders, a rule under the header, centered cells, images filling their cells. Passthrough names it as the class; extension names it in each tool’s own way (a directive class in Docusaurus, a style option in Zensical, Markdoc’s class shorthand in Starlight, a role in Antora). Native keeps the standard style (decided), although Starlight’s and Antora’s own table syntax could name it. The published page opens the charts in a lightbox script; the converted pages link to the image. This table on the published page.

Published docs.cloudfoundry.org
Published uaa-performance table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1

_oss_roles_table

docs-cloudfoundry-concepts · partial included by roles; added 2026-10-12 · published page · 1 table

Table 1 Activity / eleven roles

Twelve columns, wider than the content column in every tool. Each tool scrolls it in a box of its own and lays it out at its narrowest, each column as wide as its longest word, so the activity column wraps on every row; Zensical gives every column the same 100 pixels. The published page has no box: the table spills 154 pixels into the margin. Full table shows every column; As seen shows the part each tool’s box shows before the reader scrolls it. This table on the published page.

Published docs.cloudfoundry.org
Published _oss_roles_table table 1
Docusaurus 3.10.2 passthrough
Docusaurus 3.10.2 table 1
Zensical 0.0.69 passthrough
Zensical 0.0.69 table 1
Starlight 0.42.6 passthrough
Starlight 0.42.6 table 1
Antora 3.2.1 passthrough
Antora 3.2.1 table 1