ContactJoin us

Markdown, made for research

A shared language for writing, and a flexible set of components for presenting ideas. Explore the article format in one place.

Abel AI LabDesign reference
  • Format example
  • Markdown
Authors & affiliations
Abel AI Lab
Article design & engineering
Three connected stages: a question, supporting evidence, and an insight.

Write once. Style together.

This page is a format example, not a research result. It brings the building blocks of an article together so writers and designers can see how they work.1

A writer supplies the ideas. A shared set of components gives those ideas a consistent shape: clear emphasis, a change in voice, a superseded thought, and a precise name such as sample_count.

A useful research article makes the question, the evidence, and the limits easy to find.

A small publishing routine

  1. Copy the article template into a new folder.
  2. Add the text and its supporting files.
  3. Review the preview with the team.
  • Keep related files together.
    • Images live beside the article.
    • Code and static outputs can live there too.
  • Let components take care of presentation.

Before review, check the essentials:

This is a read-only checklist. For the source format, see the Markdown documentation.

Figures with context

A normal Markdown image stands on its own:

A question leads to evidence, which leads to an insight.

When a figure needs a visible caption and a stable reference, use the figure block. The caption below belongs to the same component as its image.

A question, supporting evidence, and an insight connected from left to right.
Figure 1. A simple path from question to evidence to insight.

Tables that stay readable

The values here demonstrate alignment and emphasis. They are illustrative, and do not report a benchmark.

ElementSourceExample count
Observationsn2,000
Variablesd20
Repeatsr5

Tables keep their column alignment on a small screen and can scroll within the reading column.

Code, without a screenshot

A fenced block can carry a language and a filename. Highlighting is prepared with the article; the reader receives the code as text.

A named source file

example.pypython
observations = [(1, 2), (2, 3), (3, 4)]
sample_count = len(observations)
print(f"Samples: {sample_count}")

Source and static output

The output below is written by the author. The page does not execute this code.

example.pypython
observations = [(1, 2), (2, 3), (3, 4)]
print(f"Samples: {len(observations)}")
OutputStatic text
Samples: 3

Files that travel with the article

The next blocks load the bundled source and its recorded output.

example.pypython
observations = [(1, 2), (2, 3), (3, 4)]
sample_count = len(observations)
print(f"Samples: {sample_count}")
OutputPlain text
Samples: 3

A fence without a language is still a code block:

CodePlain text
This fence has no language.
Whitespace and line breaks stay intact.

Notes and references

A little more context

Supporting material can remain close to the main explanation without interrupting it.

  • This disclosure contains ordinary Markdown.
  • It works with a keyboard and opens without JavaScript.

A note on scope: charts and interactive demonstrations need their own component contract. This first example focuses on the article's basic elements.

A repeatable section

Headings generate links for the contents list. The first occurrence has its own stable anchor.

A repeatable section

A repeated heading receives a different anchor, so each section remains reachable.

A final paragraph can link back to the figure, or to the article list.

Footnotes

  1. This sample is for reviewing article structure, typography, and authoring conventions. It makes no claim about a model or a research finding. ↩