Why convert TYP to MD?
A .typ file is Typst-specific markup, while .MD is lightweight Markdown that GitHub, static-site generators, and note apps read everywhere. Converting frees the plain content from Typst so it can live in wikis, READMEs, or documentation pipelines.
How to convert TYP to MD
Pandoc (command line)
With Pandoc 3.1.8+ run pandoc -f typst -t markdown main.typ -o main.md to turn the Typst source into a Markdown file.
Pandoc to GitHub-flavored Markdown
Use pandoc -f typst -t gfm main.typ -o main.md when you specifically need GitHub-flavored Markdown for a repo README or docs.
About these formats
A .typ file is a plain-text source document written for Typst, an open-source markup-based typesetting system. It holds your text mixed with Typst markup, math, and scripting, which the…
Open .TYP details →
.MD
Markdown Document
An MD file is a Markdown document: plain text that uses simple marks like # for headings and bold for emphasis. Any text editor opens the raw content. To see it properly formatted, use VS…
Open .MD details →Quality & what to watch
- The Typst reader is limited:
#set/#showrules, custom functions, and packages are often ignored or flattened. - Markdown has no concept of Typst's precise layout, so columns, exact spacing, and positioned elements are dropped.
- Some constructs (certain horizontal rules or complex tables) can convert imperfectly and may need manual cleanup.
Frequently asked questions
Does Pandoc really read Typst source?
-f typst reads .typ files directly.Will Typst math convert to Markdown?
Why did some formatting disappear?
Which Markdown flavor should I target?
markdown is the default; use -t gfm for GitHub, or -t commonmark for strict CommonMark.
