Blog formatting
Publishing markdown blogs can be done through the button on the homepage. This page describes the custom features we support for these blogs.
Standard Markdown is supported, plus tables, footnotes, highlighted code blocks, and inline and display math. See the Markdown basic syntax reference. A leading # Title becomes the blog's title and is removed from the body, which must not be empty; sections use ##, and a later # heading is rejected. The byline and optional abstract come from the publication fields.
ImageCaption
An image with a rich caption and the blog image viewer.
| Attribute | Required | Meaning |
|---|---|---|
src | Yes | Path to the image inside the uploaded ZIP. |
alt | No | Text describing the image. |
| Children | No | Caption content; Markdown and supported inline HTML. |
<ImageCaption src="images/results.png" alt="Accuracy by method">
<strong>Figure 1.</strong> Accuracy on the evaluation set.
</ImageCaption>
Tabs · Tab
Switchable content panels. Tabs takes direct Tab children and opens the first panel initially.
| Element | Attribute | Required | Meaning |
|---|---|---|---|
Tabs | — | — | Container for the panels. |
Tab | label | Yes | Plain-text label shown in the tab row. |
Tab | Children | No | Panel content; Markdown and supported HTML. |
<Tabs>
<Tab label="Method">
<p>The <strong>method</strong> and its assumptions.</p>
</Tab>
<Tab label="Results"> <p>The results and their interpretation.</p> </Tab>
</Tabs>
HTML support
| Category | Elements |
|---|---|
| Structure | p, br, hr, h2–h6, div, span, section |
| Emphasis | em, strong, b, i, s, del, sub, sup, kbd, mark |
| Links and images | a, img, figure, figcaption |
| Code and quotations | code, pre, blockquote |
| Lists | ul, ol, li |
| Tables | table, thead, tbody, tr, th, td |
Use literal attribute values. Keep blank lines around Markdown nested in HTML. Component names are case-sensitive — ImageCaption, Tabs, Tab — and custom elements require explicit closing tags, even with no children.
The alphaXiv app reads posts as MDX, so uploads must also parse as MDX and render the same in both readers: self-close empty tags (<br />, <img src="…" />), escape a literal {, }, or < in text as \{, \}, or \<, keep every start tag on one line, fence every code block instead of indenting it, write links as [text](url) instead of <url>, and leave out HTML comments.
Scripts, iframes, inline SVG, forms, and unlisted components are rejected. Event handlers, inline styles, and unsupported attributes are removed. Imports and JavaScript expressions are never executed.
Images and upload limits
Images must be bundled in a .zip alongside the Markdown file and referenced by relative path, such as .
| Resource | Limit |
|---|---|
| Markdown | 1 MB |
| ZIP | 50 MB compressed and expanded; 200 entries |
| Images | 50 distinct sources; 10 MB each; 50 MB total |
Please contact us if you would like to publish a blog exceeding these limits.