Help Center
Clear, practical guides for writing, compiling, and sharing LaTeX and Typst projects.
Write in Markdown
Edit .md files as source or as formatted text, preview them live, and convert them to LaTeX or Typst.
Switch between Source and Visual
A Markdown file (.md or .markdown) has two views of the same text: Source shows the Markdown as you type it, and Visual shows it formatted while you edit.
How to do it
- Open a Markdown file. It opens in Source.
- Select the Source / Visual switch at the start of the toolbar under the tab, or run Markdown: Switch to visual editor from the command palette. Select it again to go back.
- In Visual, headings, lists, tables, images and formulas are drawn as they will read. Put the caret in a formula to edit its source, with a Formula preview under it.
- Select an image to get Edit image, where you change its Path or URL and Alt text and choose Apply, and Remove image. Point at a link for Open link and Remove link.
- Select text in Visual to Add Comment, Add to Chat or Quick Edit. Collaborators' edits, comments and tracked changes show in both views.
- Both views share the caret, so switching keeps your place. The view is chosen per tab.
Format with the toolbar
On a Markdown tab the toolbar inserts Markdown, and its buttons work the same in Source and Visual.
How to do it
- After the Source / Visual switch come Undo, Redo, Heading level (1 to 6), Bold, Italic, Inline code, Insert link, Insert footnote, Insert list, Insert figure, Insert table, Insert aligned equations, Insert display equation and Insert fraction. What does not fit moves into More Markdown actions at the end.
- Choose a Heading level on a paragraph or heading to set its level; elsewhere it inserts a new heading.
- Insert list offers a Bulleted list or a Numbered list, and Insert table lets you pick the size.
- Markdown has no underline, citation or cross-reference, so those buttons are not shown on a Markdown tab.
- Right-click the toolbar and choose Hide text toolbar to hide the formatting buttons; the Source / Visual switch stays. Text toolbar in the editor settings brings them back.
Preview a Markdown file
The preview renders the file as you and your collaborators type, without compiling.
How to do it
- Select Preview in the tab bar of a Markdown tab, or press Ctrl+K, then V (⌘K, then V on a Mac). The preview opens beside the source.
- It shows tables, task lists, footnotes, math written with $ and $$, Mermaid diagrams, and alerts such as > [!NOTE] as callouts. A YAML front matter is left out, and HTML in the file is not shown.
- Images can be files of the project, by path from the Markdown file, or https addresses. A link to another file of the project opens that file.
- The preview follows the source as you scroll it. Double-click a block, or Ctrl-click it (Cmd-click on a Mac), to jump to its line in the source.
- Right-click the preview for Jump to source and Open source file.
Bring Markdown in and take it out
Markdown can become LaTeX or Typst, and a LaTeX or Typst project can be exported as Markdown.
How to do it
- To start a project from a Markdown draft, open the arrow beside New project, choose Import from files, pick the .md file, choose LaTeX or Typst and choose Start import.
- Inside a project, right-click a .md file in the Explorer and choose Convert to LaTeX (Convert to Typst in a Typst project); the result is written beside it.
- To get a Markdown copy of a project, open the ••• Project actions button in the title bar and choose Markdown (.md) under Export. Equations stay as TeX and images go into a folder beside the text.
- Personal Notes are Markdown too: Download on a page without images saves its .md file.
