No description
Find a file
Barrett Ruth 0f353446b6
fix(presets): correct error parsers for real compiler output (#11)
Problem: all three built-in error parsers were broken against real
compiler output. Typst set source to the relative file path, overriding
the provider name. LaTeX errors go to stdout but the parser only
received stderr. Pandoc's pattern matched "Error at" but not the real
"Error parsing YAML metadata at" format, and single-line parsing missed
multiline messages.

Solution: pass combined stdout+stderr to error_parser so LaTeX stdout
errors are visible. Remove source = file from the Typst parser so
diagnostic.lua defaults it to the provider name. Rewrite the Pandoc
parser with line-based lookahead: match (line N, column N) regardless
of prefix text, skip YAML parse exception lines when looking ahead for
the human-readable message. Rename stderr param to output throughout
diagnostic.lua, presets.lua, and init.lua annotations.
2026-03-03 14:14:59 -05:00
.github/workflows ci: format 2026-03-01 17:22:59 -05:00
doc Refactor/preset name true syntax (#4) 2026-03-03 00:49:10 -05:00
lua/preview fix(presets): correct error parsers for real compiler output (#11) 2026-03-03 14:14:59 -05:00
plugin feat: rename 2026-03-02 21:23:40 -05:00
spec fix(presets): correct error parsers for real compiler output (#11) 2026-03-03 14:14:59 -05:00
.busted ci: format 2026-03-01 17:22:59 -05:00
.editorconfig ci: format 2026-03-01 17:22:59 -05:00
.gitignore ci: format 2026-03-01 17:22:59 -05:00
.luarc.json ci: format 2026-03-01 17:22:59 -05:00
.prettierrc ci: format 2026-03-01 17:22:59 -05:00
flake.lock ci: format 2026-03-01 17:22:59 -05:00
flake.nix feat: rename 2026-03-02 21:23:40 -05:00
LICENSE ci: format 2026-03-01 17:22:59 -05:00
preview.nvim-scm-1.rockspec feat: rename 2026-03-02 21:23:40 -05:00
README.md doc: cleanup readme 2026-03-03 13:44:43 -05:00
selene.toml ci: format 2026-03-01 17:25:34 -05:00
stylua.toml ci: format 2026-03-01 17:22:59 -05:00
vim.yaml ci: format 2026-03-01 17:22:59 -05:00

preview.nvim

Async document compilation for Neovim

An extensible framework for compiling documents (LaTeX, Typst, Markdown, etc.) asynchronously with error diagnostics.

Features

  • Async compilation via vim.system()
  • Built-in presets for Typst, LaTeX, Markdown, and GitHub-flavored Markdown
  • Compiler errors as native vim.diagnostic
  • User events for extensibility (PreviewCompileStarted, PreviewCompileSuccess, PreviewCompileFailed)

Requirements

  • Neovim 0.11+

Installation

Install with your package manager of choice or via luarocks:

luarocks install preview.nvim

Documentation

:help preview.nvim

FAQ

Q: How do I define a custom provider?

require('preview').setup({
  typst = {
    cmd = { 'typst', 'compile' },
    args = function(ctx)
      return { ctx.file }
    end,
    output = function(ctx)
      return ctx.file:gsub('%.typ$', '.pdf')
    end,
  },
})

Q: How do I override a preset?

require('preview').setup({
  typst = { env = { TYPST_FONT_PATHS = '/usr/share/fonts' } },
})

Q: How do I automatically open the output file?

Set open = true on your provider (all built-in presets have this enabled) to open the output with vim.ui.open() after the first successful compilation. For a specific application, pass a command table:

require('preview').setup({
  typst = { open = { 'sioyek', '--new-instance' } },
})