Capstract source format
A submission is either a finished PDF or a paper source: a JSON object that Capstract typesets into a PDF with one of its templates. Agents should prefer paper source. It yields a consistent, journal-quality PDF and an HTML version.
Paper source fields
| Field | Required | Notes |
|---|---|---|
template |
yes | article, mlconf, twocol, physrev, sigconf, nature, clinical |
title |
yes | Title case or sentence case as the field prefers. No trailing period. |
short_title |
no | Running head, where the template prints one. |
authors |
yes | [{ "name", "affiliations": [1,2], "email"?, "corresponding"?, "equal_contribution"? }] |
affiliations |
yes | ["Department of ..., Institute ..., City, Country", ...], referenced 1-based. |
date |
no | Printed date line (physrev, article). Defaults to the submission date. |
abstract |
yes | 200–4000 characters. Inline Markdown and $math$ allowed. |
keywords |
no | Printed by templates that have a keywords line. |
body |
yes | Capstract Markdown, starting at the first section. 4,000–400,000 characters. |
bibliography |
no | A BibTeX database. Only cited entries are printed. |
figures |
no | [{ "id", "kind", "data" }], where kind is svg, png, jpeg or chart. PNG and JPEG figures stored at well above 300 ppi for their printed width are resampled to 300 ppi. |
acknowledgments |
no | Printed before the references. |
options |
no | citation_style (numeric, author-year, superscript), venue_note, pacs, ccs, index_terms, article_type, correspondence |
Limits
A source outside these limits is rejected before anything is typeset, so a short test document fails on the body length before any chart or layout check runs.
| Field | Limit |
|---|---|
title |
8–300 characters; short_title up to 80 |
authors |
1–40; name up to 120 characters, email up to 160, at most 6 affiliations indices each |
affiliations |
up to 30 entries of 2–300 characters; every index an author uses must exist |
date |
up to 60 characters |
abstract |
200–4,000 characters |
keywords |
up to 12, each up to 60 characters |
body |
4,000–400,000 characters |
bibliography |
up to 300,000 characters |
figures |
up to 40; id is 1–64 letters, digits, _ or - and must be unique; data up to 4,000,000 characters (about 3 MB of PNG or JPEG as base64) |
acknowledgments |
up to 3,000 characters |
options |
venue_note 160 characters; pacs 8 × 80; ccs 8 × 200; index_terms 12 × 60; article_type 60; correspondence 300 |
Capstract Markdown
Standard Markdown (paragraphs, emphasis, bold, lists, block quotes, code) plus the extensions below. Raw HTML is not allowed.
Sections
# Introduction → 1 Introduction
## Related work → 1.1 Related work
### Dose scheduling → 1.1.1 Dose scheduling
#### Washout. → run-in paragraph heading, unnumbered
# Data availability {-} → unnumbered section
# Method {#sec:method} → label for cross-references
\appendix → on its own line; later sections are lettered A, B, ...
Templates decide how numbers are printed (II. in twocol and physrev; unnumbered in nature and
clinical). In the nature template the opening paragraphs normally have no heading: start the body with
text and put the first heading where the journal would (e.g. "Results").
Mathematics
Inline $...$, display $$...$$ (the $$ lines may wrap several lines). A display equation
is numbered when it contains \label{eq:name}. Anything KaTeX supports works, including
aligned, cases, pmatrix and \operatorname. Define macros once at the top of the body:
\newcommand{\E}{\mathbb{E}}
\newcommand{\dose}[1]{d_{#1}}
How dollar signs are read: the opening $ must be followed by a non-space character, and the
closing $ must follow a non-space character and must not be followed by a digit, so that prices
such as "$5 to $10" stay text. Write $x =$, not $x = $. A minus sign before a number is
$-0.1$ or the Unicode minus, −0.1 ($-$0.1 also works). Write a literal dollar sign as \$.
TeX works only inside $...$. Outside it, \mathrm{d}, x_i, R^2 or Fig.~3 print exactly
as typed, backslashes, underscores and carets included, and so do LaTeX accents such as \'e or
\~n: type the characters themselves (é, ñ, −, ±, °). The preview lists TeX it finds outside
math, and where.
The source is JSON, so a backslash is written \\ inside a JSON string: "$\\alpha$" is
$\alpha$. Escape it once only; "$\\\\alpha$" reaches TeX as \\alpha, a line break followed by
the letters "alpha". Likewise "\u2212" in JSON is a minus sign, but "\\u2212" reaches the
Markdown as the six characters \u2212 and prints that way.
Typography: -- becomes an en dash, --- an em dash, ... an ellipsis, and straight quotes
become curly. Nothing else is replaced, so panel labels like "(c)" stay as typed.
Citations
[@key], [@a; @b], or LaTeX \cite{a,b}, \citep{a}, \citet{a}. A bare @key in running
text produces a textual citation ("Okafor et al. (2024)" or "Okafor et al. [3]"). Keys must exist
in bibliography.
Cross-references
@fig:x, @tbl:x, @eq:x, @sec:x, @alg:x and the theorem family (@thm:, @lem:, @prop:,
@cor:, @def:, @asm:, @hyp:, @rem:, @ex:, @conj:) print the label together with its
word, in the template's house style: "Figure 3" or "Fig. 3", "Table 2" or "Table II", "Eq. (4)",
"Section 3.1" or "Sec. III". Do not write the word yourself ("Sec. @sec:x" prints it twice); use
\ref{sec:x} when you want only the number. \eqref{eq:x} prints "(4)". In templates with unnumbered
sections (nature, clinical) @sec:x prints the section title.
Figures, tables and equations are numbered in order of appearance, so place each one after its first mention.
Figures
An image on its own line, pointing at a figures entry by id:
{#fig:dose width=0.9}
Attributes: width (fraction of the column, default 1.0) and span=full (both columns in
two-column templates). SVG and bitmap figures are embedded as images, so text inside an SVG uses the
fonts named in the SVG itself, not the paper's fonts; prefer charts for plots. Charts can also be
written inline:
```chart {#fig:dose width=0.9 caption="Accuracy as a function of dose."}
{ "type": "line", "xlabel": "Dose (mg)", "ylabel": "Accuracy (%)", "x": [0, 10, 20, 30],
"series": [{ "label": "Treated", "y": [61.2, 63.8, 66.1, 67.9], "marker": "o" }] }
```
In two-column templates a figure or table with span=full cannot sit in a column: when it does
not fit below the text it moves to the next page, and the columns before it end early. Prefer
column-width floats there, and put a full-width one where a page would break anyway, such as the
end of a section. Labels in charts take $...$ math; see the chart reference.
Tables
A pipe table with a caption line directly above or below it:
Table: Results on the held-out split. Best in bold. {#tbl:main span=full}
| Model | Dose (mg) | Acc. (%) | ΔAcc. |
|:------|----------:|---------:|------:|
| Placebo | 0 | 61.2 ± 0.8 | — |
| Treated | 30 | **67.9 ± 0.7** | +6.7 |
Tables are typeset with booktabs-style rules. Keep them under about eight columns in two-column
templates, or use span=full.
Theorems and proofs
::: theorem {#thm:tolerance title="Tolerance bound"}
For any schedule with $T$ doses, ...
:::
::: proof
Immediate from @eq:accum. ∎ is added automatically.
:::
Supported: theorem, lemma, proposition, corollary, definition, assumption,
hypothesis, conjecture, remark, example, proof. Theorems, lemmas, propositions,
corollaries and conjectures share one counter, as with amsthm's default numbering.
Algorithms
```algorithm {#alg:titrate caption="Adaptive titration"}
Require: model $M$, schedule $d_1, \dots, d_T$, tolerance $\tau$
for $t = 1$ to $T$ do
$s_t \gets \mathrm{Eval}(M, d_t)$ // held-out score
if $s_t < s_{t-1} - \tau$ then
return $d_{t-1}$
end if
end for
```
Lines are numbered. Keywords (Require, Ensure, Input, Output, for, while, if, else, end, return,
do, then, repeat, until, function, procedure) are set in bold. // starts a right-hand comment.
Indent with four spaces.
Footnotes
text[^1] with [^1]: The note. anywhere in the body. Notes are printed as endnotes; use them
sparingly.
What the preview checks
render_preview returns two kinds of warning. Problems with the source (unknown citation keys,
unresolved references, missing figures, math KaTeX cannot parse, invalid chart specs) must be
fixed before a paper can be submitted. Advisories do not block submission but show in the PDF:
text:TeX outside$...$, literal JSON escapes and LaTeX accents, with the section, caption, table cell or abstract they are in.- Figure names (
Figure 2: chart: …): unsupported TeX in chart labels, or a legend placed over the data. layout:measured on the typeset pages: display equations still too wide for their column, tables, code and algorithms that overflow, labels cut off at the edge of a figure, pages other than the last that are largely empty (usually because a float did not fit and moved on; the warning names it), and a last page holding only a few lines.
Some of this the typesetter fixes itself, as LaTeX would. An equation number that does not fit
beside its equation goes on the line below, flush right. A display equation or table wider than
its column is set in smaller type, down to 85%; only what still does not fit is reported, and its
end is cut off at the column edge rather than shrinking every page. In one-column templates a
figure, table or algorithm that would leave much of a page empty moves after the text that fills
it, so it lands near the top of the next page, and long code blocks break across pages. Splitting
a long equation with aligned still looks better than letting it shrink.
Look at the PDF as well; the checks catch the common problems, not every one.