A highly-customisable & feature rich markdown previewer inside Neovim.

📖 Wiki page | 🎮 Usage examples

🔋 Extras | 🧩 Presets

Markdown renderer,

• Block quote support with custom callouts/alertd. Supports callout titles too.
• Checkbox with custom states.
• Code blocks. Also supports info strings added before the code blocks.
• Footnotes.
• Headings(both atx & setext).
• Horizontal rules.
• Inline codes.
• Links(hyperlinks, image links & email).
• List items(+, -, *, n. & n))
• Tables. Supports content alignment, pre-defined column widths and rendering other markdown & html syntaxes inside of table cells.

HTML renderer,

• HTML elements(only inline ones). Also supports defining styles for custom tags.
• HTML entities. Supports 242 entities(as of last edit).

LaTeX renderer,

• Inline LaTeX support.
• LaTeX block supoort.
• LaTeX symbols support. supports 1000+ symbol names.
• Font commamd support. Currently supports: \mathbfit, \mathcal, \mathfrak, \mathbb, \mathsfbf, \mathsfit, \mathsfbfit, \mathtt.
• Subscripts & superscripts

Others,

• Hybrid mode, for previewing & editing.
• Split view, for showing preview in a split.
• Presets, for easy customisation.
• Tree-sitter injections, supports overwrites too!

Extras,

• Heading level cycler.
• Checkbox toggler & cycler.

• Neovim version >=0.10.1.
• Tree-sitter parsers: markdown, markdown_inline, html.
• Nerd font.

Optional,

• Tree-sitter parsers: latex.
• nvim-tree/nvim-web-deviconso.
• Any modern unicode font.
• A tree-sitter supported colorscheme.

markview.nvim can be installed via your favourite plugin manager!

{
    "OXY2DEV/markview.nvim",
    lazy = false,      -- Recommended
    -- ft = "markdown" -- If you decide to lazy-load anyway

    dependencies = {
        "nvim-treesitter/nvim-treesitter",
        "nvim-tree/nvim-web-devicons"
    }
}

local MiniDeps = require("mini.deps");

MiniDeps.add({
    source = "OXY2DEV/markview.nvim",

    depends = {
        "nvim-treesitter/nvim-treesitter",
        "nvim-tree/nvim-web-devicons"
    }
});

:Rocks install markview.nvim

Current version: v25.0.0

New features are usually done on the dev branch first.

So, If you are curious about them, try this branch out!

The configuration table is too large to fit here.

Go check the wiki page or see :h markview.nvim-configuration.

Here's all the main options,

{
    -- Buffer types to ignore
    buf_ignore = { "nofile" },
    -- Delay, in miliseconds
    -- to wait before a redraw occurs(after an event is triggered)
    debounce = 50,
    -- Filetypes where the plugin is enabled
    filetypes = { "markdown", "quarto", "rmd" },
    -- Highlight groups to use
    -- "dynamic" | "light" | "dark"
    highlight_groups = "dynamic",
    -- Modes where hybrid mode is enabled
    hybrid_modes = nil,
    -- Tree-sitter query injections
    injections = {},
    -- Initial plugin state,
    -- true = show preview
    -- falss = don't show preview
    initial_state = true,
    -- Max file size that is rendered entirely
    max_file_length = 1000,
    -- Modes where preview is shown
    modes = { "n", "no", "c" },
    -- Lines from the cursor to draw when the
    -- file is too big
    render_distance = 100,
    -- Window configuration for split view
    split_conf = {},

    -- Rendering related configuration
    block_quotes = {},
    callbacks = {},
    checkboxes = {},
    code_blocks = {},
    escaped = {},
    footnotes = {},
    headings = {},
    horizontal_rules = {},
    html = {},
    inline_codes = {},
    latex = {},
    links = {},
    list_items = {},
    tables = {}
}

markview.nvim has a single command :Markview.

When used without any subcommands, it toggles the plugin.

Available subcommands,

• toggleAll
• enableAll
• disableAll
• toggle {n}
• enable {n}
• disable {n}
• hybridToggle
• hybridEnable
• hybridDisable
• splitToggle {n}
• splitEnable {n}
• splitDisable {n}

Additional command(s),

• MarkOpen, Opens the link under cursor, falls back to vim.ui.open().

Highlight groups defined by the plugin are given below.

• Block quotes

  • MarkviewBlockQuoteWarn
  • MarkviewBlockQuoteSpecial
  • MarkviewBlockQuoteNote
  • MarkviewBlockQuoteDefault
  • MarkviewBlockQuoteOk
  • MarkviewBlockQuoteError

• Checkboxes

  • MarkviewCheckboxCancelled
  • MarkviewCheckboxChecked
  • MarkviewCheckboxPending
  • MarkviewCheckboxProgress
  • MarkviewCheckboxUnchecked
  • MarkviewCheckboxStriked

• Code blocks & Inline codes

  • MarkviewInlineCode
  • MarkviewCodeInfo
  • MarkviewCode

• Code block icons(Internal icon provider)

  • MarkviewIcon1
  • MarkviewIcon1Sign
  • MarkviewIcon1Fg
  • MarkviewIcon2
  • MarkviewIcon2Sign
  • MarkviewIcon2Fg
  • MarkviewIcon3
  • MarkviewIcon3Sign
  • MarkviewIcon3Fg
  • MarkviewIcon4
  • MarkviewIcon4Sign
  • MarkviewIcon4Fg
  • MarkviewIcon5
  • MarkviewIcon5Sign
  • MarkviewIcon5Fg
  • MarkviewIcon6
  • MarkviewIcon6Sign
  • MarkviewIcon6Fg

• Headings

  • MarkviewHeading1Sign
  • MarkviewHeading1
  • MarkviewHeading2Sign
  • MarkviewHeading2
  • MarkviewHeading3Sign
  • MarkviewHeading3
  • MarkviewHeading4Sign
  • MarkviewHeading4
  • MarkviewHeading5Sign
  • MarkviewHeading5
  • MarkviewHeading6Sign
  • MarkviewHeading6

• Horizontal rules

  • MarkviewGradient1
  • MarkviewGradient2
  • MarkviewGradient3
  • MarkviewGradient4
  • MarkviewGradient5
  • MarkviewGradient6
  • MarkviewGradient7
  • MarkviewGradient8
  • MarkviewGradient9
  • MarkviewGradient10

• LaTeX

  • MarkviewLatexSubscript
  • MarkviewLatexSuperscript

• List items

  • MarkviewListItemStar
  • MarkviewListItemPlus
  • MarkviewListItemMinus

• Links

  • MarkviewEmail
  • MarkviewImageLink
  • MarkviewHyperlink

• Tables

  • MarkviewTableHeader
  • MarkviewTableBorder
  • MarkviewTableAlignCenter
  • MarkviewTableAlignLeft
  • MarkviewTableAlignRight

Don't forget to check out the wiki!

Hybrid mode can be used by just modifying the hybrid_modes option.

require("markview").setup({
    hybrid_modes = { "n" }
});

You can show previews in a split!

:Markview splitToggle

You can use tree-sitter injections for folding text!

You first need to modify the fold method and the expression used for folding text.

vim.o.foldmethod = "expr";
vim.o.foldexpr= "nvim_treesitter#foldexpr()";

Now, we create a query to fold the headings.

require("markview").setup({
    injections = {
        languages = {
            markdown = {
                --- This disables other
                --- injected queries!
                overwrite = true,
                query = [[
                    (section
                        (atx_headng) @injections.mkv.fold
                        (#set! @fold))
                ]]
            }
        }
    }
});

Here's a bit of explanation on what the text does.

; Matches any section of text that starts with
; a heading.
(section
    (atx_headng) @injections.mkv.fold
    ; This folds the section!
    (#set! fold))

Optionally, you can use a foldtext plugin tp change what is shown! For example, I can use foldtext.nvim for this.

local def = require("foldtext").configuration;
local handler = function (_, buf)
    local ln = table.concat(vim.fn.getbufline(buf, vim.v.foldstart));
    local markers = ln:match("^%s*([#]+)");
    local heading_txt = ln:match("^%s*[#]+(.+)$");

    local icons = {
        "󰎤", "󰎩", "󰎪", "󰎮", "󰎱", "󰎵"
    }

    return {
        icons[vim.fn.strchars(markers or "")] .. heading_txt,
        "MarkviewHeading" .. vim.fn.strchars(markers or "");
    }
end
local spaces = function (_, buf)
    local ln = table.concat(vim.fn.getbufline(buf, vim.v.foldstart));
    local markers = ln:match("^%s*([#]+)");
    local heading_txt = ln:match("^%s*[#]+(.+)$");

    return {
        string.rep(" ", vim.o.columns - vim.fn.strchars(heading_txt) - 1),
        "MarkviewHeading" .. vim.fn.strchars(markers or "");
    }
end

require("foldtext").setup({
    custom = vim.list_extend(def, {
        {
            ft = { "markdown" },
            config = {
                { type = "indent" },
                {
                    type = "custom",
                    handler = handler
                },
                {
                    type = "custom",
                    handler = spaces
                }
            }
        }
    });
});