/typst.vim

Vim plugin for Typst

Primary LanguageVim ScriptMIT LicenseMIT

typst.vim

OBS: Work In Progress

(Neo)vim plugin for Typst.

I am applying the 80/20 rule in this project since I prefer to have something now rather than waiting for everthing later.

Features

image Editing typst-palette in Vim with the gruvbox colorscheme

Existing

  • Vim syntax highlighting.
  • Compile the active document with :make.
  • Concealing for italic, bold. You must set conceallevel=2 for this to work.
  • Concealing symbols in math mode. You must set conceallevel=2 and the g:typst_conceal_math option.

Possible features

  • Formatting using this?
  • Even better highlighting for neovim using treesitter?

Do you miss anything from other packages, e.g. vimtex, create an issue and I'll probably add it! Also feel free to make a PR!

Installation

packer.nvim

require('packer').startup(function(use)

    use {'kaarmu/typst.vim', ft = {'typst'}}

end)
  • Restart neovim to reload config
  • Call :PackerSync

lazy.nvim

return {
  'kaarmu/typst.vim',
  ft = 'typst',
  lazy=false,
}

vim-plug

call plug#begin('~/.vim/plugged')
    Plug 'kaarmu/typst.vim'
call plug#end()
  • Restart (neo)vim to reload config
  • Call :PlugInstall

Usage

Options

  • g:typst_cmd: Specifies the location of the Typst executable. Defaults to "typst".
  • g:typst_pdf_viewer: Specifies pdf viewer that typst watch --open will use.
  • g:typst_conceal_math: Enable concealment for math symbols in math mode (i.e. replaces symbols with their actual unicode character). OBS: this can affect performance, see issue #64.
  • g:typst_auto_close_toc: Specifies whether TOC will be automatically closed after using it.

Commands

  • :TypstWatch: Watches your document and recompiles on change; also opens the document with your default pdf viewer.

Tips

If you are using neovim you can install typst-lsp. There exist a server configuration in nvim-lspconfig so it should be easy to set it up. The config currently requires that you're working in a git repo. Once the neovim+LSP recognizes the file the LSP will compile your document while you write (almost like a wysiwyg!). By default it will compile on save but you can set it to compile-on-write as well.