Write a research article
Use article() when you need a compact research-paper structure with author information and an abstract above a two-column body. The article generates its title block, but no separate cover page. Add your own cover or an optional Satz cover before the article show rule if you need one. This tutorial uses the Satz 0.2.0 local package and fictional research content.
1. Create the article file
Create article.typ and paste this complete starter:
#import "@local/satz:0.2.1": article#show: article.with( title: "A Small Example Study", authors: (name: "Alex Example", affiliations: (1,)), affiliations: ("Example Research Group, Sample University",), abstract: [ This example explains how to structure an article with Satz. Replace this summary with the research question, method, main finding, and conclusion. ], date: "October 2026",)
= Introduction
Explain the problem and state the question the article addresses.
= Method
Describe the participants or materials, procedure, and analysis. Include enoughdetail for a reader to understand what was done.
= Results
Report the observations and refer to any figures or tables in the text.
= Discussion
Explain what the results mean, state their limitations, and identify a usefulnext step.The #show rule formats the title block and applies the article layout to the body. The headings and paragraphs are ordinary Typst content. Change the title, author, affiliation, abstract, and date in the settings; write the article below the closing parenthesis.
2. Add more authors or affiliations
For one author, pass a record directly, with no singleton-array comma:
authors: (name: "Alex Example"),For multiple authors, pass an array of records. Add one-based affiliation numbers when authors belong to one or more affiliations:
authors: ( (name: "Alex Example", affiliations: (1, 2)), (name: "Sam Reader", affiliations: (2,)),),affiliations: ( "Example Research Group, Sample University", "Methods Lab, Example Institute",),Every affiliation number must point to an entry in affiliations. The article checks this when it compiles and reports an error if a number is missing or out of range.
3. Change to a one-column layout
For an assignment or a manuscript that should use one column, add a shared page override inside article.with(...):
config: (page: (columns: 1)),This only changes the page column count; the other article defaults remain in place. Keep the default two-column layout when preparing a compact paper. See the article API for metadata fields and the configuration reference for each shared setting.
4. Compile and inspect
Compile with the local 0.2.0 package:
typst compile --package-path packages article.typCheck that the title, superscript affiliation markers, abstract, and section order are correct. In two columns, review figures and tables for width and placement. A figure intended to span both columns needs a suitable placement and scope; see Figures and tables.
This tutorial targets Satz 0.2.0 during usability testing. After publication, change @local to @preview and keep the version number unchanged.