brycewang-stanford/Auto-Empirical-Research-Skills / skills/22-christopherkenny-skills/skills/latex-to-typst
latex-to-typst
VerifiedTranslates LaTeX documents (.tex) to Typst (.typ), focusing on article-class documents. Use when asked to convert, port, migrate, or translate LaTeX to Typst. Covers document structure, text formatting, page layout, math equations and symbols, figures, tables, TikZ-to-CeTZ diagrams, bibliography, cross-references, footnotes, and code blocks. Includes comprehensive symbol mapping tables.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
| references/01-document-structure.md | markdown | 4.1 KB |
| references/02-text-formatting.md | markdown | 5.9 KB |
| references/03-page-layout.md | markdown | 4.6 KB |
| references/04-headings-sections.md | markdown | 4.1 KB |
| references/05-lists.md | markdown | 4.1 KB |
| references/06-math.md | markdown | 8.2 KB |
| references/07-math-symbols.md | markdown | 11.2 KB |
| references/08-figures.md | markdown | 5.0 KB |
| references/09-tables.md | markdown | 6.4 KB |
| references/10-bibliography.md | markdown | 4.0 KB |
| references/11-cross-references.md | markdown | 4.4 KB |
| references/12-diagrams-cetz.md | markdown | 6.5 KB |
| references/13-misc.md | markdown | 7.0 KB |
references/08-figures.md
View on GitHub# Figures and Images
## Basic Image Inclusion
```tex
% LaTeX
\usepackage{graphicx}
\includegraphics{image.png}
\includegraphics[width=0.5\textwidth]{image.png}
\includegraphics[width=5cm, height=3cm]{image.png}
\includegraphics[scale=0.75]{image.png}
```
```typst
// Typst — no import needed
#image("image.png")
#image("image.png", width: 50%)
#image("image.png", width: 5cm, height: 3cm)
#image("image.png", width: 75%)
// Fit options (when both width and height given)
#image("image.png", width: 5cm, height: 3cm, fit: "contain") // letterbox
#image("image.png", width: 5cm, height: 3cm, fit: "cover") // crop (default)
#image("image.png", width: 5cm, height: 3cm, fit: "stretch") // distort
```
## Figure Environment
```tex
% LaTeX
\begin{figure}[htbp]
\centering
\includegraphics[width=0.8\textwidth]{photo.jpg}
\caption{A descriptive caption.}
\label{fig:photo}
\end{figure}
```
```typst
// Typst
#figure(
image("photo.jpg", width: 80%),
caption: [A descriptive caption.],
) <fig:photo>
```
### Figure Placement
```tex
% LaTeX placement specifiers
\begin{figure}[h] % here
\begin{figure}[t] % top
\begin{figure}[b] % bottom
\begin{figure}[p] % separate page
\begin{figure}[H] % force here (float package)
```
```typst
// Typst
#figure(
image("photo.jpg"),
caption: [...],
placement: auto, // Typst decides (default: none = in-flow)
)
#figure(
image("photo.jpg"),
caption: [...],
placement: top, // float to top
)
#figure(
image("photo.jpg"),
caption: [...],
placement: bottom, // float to bottom
)
// In-flow (no floating) — default when placement: none
#figure(
image("photo.jpg"),
caption: [...],
)
```
### Caption Positioning
```tex
% LaTeX (caption package)
\captionsetup{position=above}
```
```typst
// Typst
#figure(
image("photo.jpg"),
caption: figure.caption(
position: top, // caption above image
[My caption text]
),
)
// Set globally
#show figure.caption: set block(above: 0.5em)
#set figure.caption(position: top) // not directly supported; use show rule
```
## Numbering and Captions
```tex
% LaTeX — default "Figure 1: ..."
\captionsetup{labelfont=bf}
\captionsetup{labelformat=simple}
```
```typst
// Typst
#set figure(numbering: "1") // default: Figure 1
// Bold label
#show figure.caption: it => [
*#it.supplement #it.counter.display(it.numbering)*#it.separator#it.body
]
// Custom separator
#show figure.caption: it => [
#it.supplement #it.counter.display(it.numbering) -- #it.body
]
```
## Subfigures
```tex
% LaTeX (subcaption)
\begin{figure}
\begin{subfigure}{0.45\textwidth}
\includegraphics[width=\linewidth]{a.png}
\caption{First subfigure}
\label{fig:a}
\end{subfigure}
\hfill
\begin{subfigure}{0.45\textwidth}
\includegraphics[width=\linewidth]{b.png}
\caption{Second subfigure}
\label{fig:b}
\end{subfigure}
\caption{Overall caption}
\label{fig:both}
\end{figure}
```
```typst
// Typst — use grid inside figure
#figure(
grid(
columns: 2,
gutter: 1em,
[
#image("a.png", width: 100%)
(a) First subfigure
],
[
#image("b.png", width: 100%)
(b) Second subfigure
],
),
caption: [Overall caption.],
) <fig:both>
// With subfigure labels via figure
#figure(
grid(
columns: 2,
gutter: 1em,
figure(image("a.png"), caption: [First], numbering: "(a)") <fig:a>,
figure(image("b.png"), caption: [Second], numbering: "(a)") <fig:b>,
),
caption: [Overall caption.],
) <fig:both>
```
## Wrapping Text Around Figures
```tex
% LaTeX (wrapfig)
\begin{wrapfigure}{r}{0.4\textwidth}
\centering
\includegraphics[width=0.35\textwidth]{image.png}
\caption{Caption}
\end{wrapfigure}
```
```typst
// Typst — use place
#place(
right,
float: false,
dx: -1em,
)[
#figure(
image("image.png", width: 5cm),
caption: [Caption],
)
]
// Or use box with float
#figure(
image("image.png", width: 40%),
caption: [Caption],
placement: right,
)
```
## Rotating Figures
```tex
% LaTeX (rotating)
\begin{sidewaysfigure}
\includegraphics{wide-figure.pdf}
\caption{Rotated}
\end{sidewaysfigure}
```
```typst
// Typst
#figure(
rotate(-90deg, reflow: true)[
#image("wide-figure.pdf", width: 20cm)
],
caption: [Rotated figure],
)
```
## Supported Image Formats
| Format | LaTeX (pdflatex) | LaTeX (lualatex/xelatex) | Typst |
|--------|-----------------|--------------------------|-------|
| PNG | ✓ | ✓ | ✓ |
| JPEG | ✓ | ✓ | ✓ |
| PDF | ✓ | ✓ | ✓ (specify page) |
| SVG | ✗ | ✓ (via package) | ✓ |
| GIF | ✗ | ✗ | ✓ (first frame) |
| EPS | ✓ | ✗ | ✗ |
| WebP | ✗ | ✗ | ✓ |
```typst
// PDF with specific page
#image("multi-page.pdf", page: 3)
```
## List of Figures
```tex
% LaTeX
\listoffigures
```
```typst
// Typst
#outline(
title: [List of Figures],
target: figure.where(kind: image),
)
```
## Accessibility
```typst
// Add alt text for accessibility
#figure(
image("chart.png", alt: "Bar chart showing annual sales from 2020 to 2024"),
caption: [Annual sales data.],
)
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |