📜 Markview.nvim

An experimental markdown previewer for Neovim.

Wiki page

✨ Features

Markview.nvim comes with a ton of features such as,

• Close to full render of markdown documents. Currently supported items are,
  • Block quotes(includes callouts/alerts.
  • Chekboxes(checked, unchecked, pending & custom states, e.g. [~] for in progress).
  • Headings(atx_headings & setext_headings).
  • Horizontal rules.
  • Html support(only for simple tags, e.g. <u>Underline</u>).
  • Html entites(both &<name>; and &<name> support).
  • Inline codes.
  • Links(hyprlinks, images & email support).
  • List item(ordered & unordered).
  • Tables.
• Fully customisable setup! You can customise everything to your needs!
• A hybrid mode that allows rendering in real-time! It will even unconceal nodes under the cursor.
• Dynamic highlight groups that allows support for almost any colorscheme!
• Supports other filetypes too(e.g. quarto/.qmd, r markdown/.rmd for now)! You can also add your own one.
• Latex support(experimental).

And a lot more to come!

📦 Requirements

• Neovim version: 0.10.0 or above.
• Tree-sitter parsers,
  • markdown
  • markdown_inline
  • html
  • latex(optional)
• Nerd font.

Optional:

• A tree-sitter supported colorscheme.

🚀 Installation

Markview can be installed via your favourite package manager.

💤 Lazy.nvim

Caution

It is not recommended to lazy-load this plugin as it does that by default.

For lazy.lua users.

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

    dependencies = {
        -- You will not need this if you installed the
        -- parsers manually
        -- Or if the parsers are in your $RUNTIMEPATH
        "nvim-treesitter/nvim-treesitter",

        "nvim-tree/nvim-web-devicons"
    }
}

For plugins/markview.lua users.

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

    dependencies = {
        -- You will not need this if you installed the
        -- parsers manually
        -- Or if the parsers are in your $RUNTIMEPATH
        "nvim-treesitter/nvim-treesitter",

        "nvim-tree/nvim-web-devicons"
    }
}

🦠 Mini.deps

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

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

    depends = {
        -- You may not need this if you don't lazy load
        -- Or if the parsers are in your $RUNTIMEPATH
        "nvim-treesitter/nvim-treesitter",

        "nvim-tree/nvim-web-devicons"
    }
})

🌒 Rocks.nvim

You can install the plugin by running the following command.

:Rocks install markview.nvim

👾 Github releases

You can also download one of the releases.

🛸 Testing

If you don't mind a slightly unstable version of the plugin then you can use the dev branch.

🌇 Commands

Markview comes with a single command.

:Markview

It has the following sub-commands,

• toggleAll, Toggles the plugin. Will set all attached buffers state to the plugin state.
• enableAll, Enables the plugin in all attached buffers. Will refresh the decorations if the plugin is already enabled.
• disableAll, Disables the plugin in all attached buffers. Will try to remove any remaining decorations if the plugin is already disabled.
• toggle {buffer}, Toggles the state of buffer.
• enable {buffer}, Enables/Refreshes the plugin on a specific buffer.
• disable {buffer}, Disables the plugin & clears decorations on a specific buffer.
• splitToggle {buffer}, Toggles the preview in a split.
• splitEnable {buffer}, Enables the preview in a split.
• splitDisable { buffer}, Disables the preview.

🚀 Hybrid mode

Hybrid mode is a new feature added to the plugin. It can be used for showcasing or editing files while you type.

It uses tree-sitter to remove decorations from a range. It will do the following,

• Removes decorations from the entire block element the cursor is currently on.
• Removes decorations from parent list items to make editing more practical.
• Removes decorations from the entire code block to prevent losing indentation.

Here's the recommended config to use this feature.

require("markview").setup({
    modes = { "n", "no", "c" }, -- Change these modes
                                -- to what you need

    hybrid_modes = { "n" },     -- Uses this feature on
                                -- normal mode

    -- This is nice to have
    callbacks = {
        on_enable = function (_, win)
            vim.wo[win].conceallevel = 2;
            vim.wo[win].concealcursor = "c";
        end
    }
})

Here's a minimal config for using this in insert-mode.

require("markview").setup({
    modes = { "n", "i", "no", "c" },
    hybrid_modes = { "i" },

    -- This is nice to have
    callbacks = {
        on_enable = function (_, win)
            vim.wo[win].conceallevel = 2;
            vim.wo[win].concealcursor = "nc";
        end
    }
})

🧭 Configuration

You can use the setup() function to change how the plugin looks.

local markview = require("markview");
local presets = require("markview.presets");

markview.setup({
    headings = presets.headings.glow_labels
});

vim.cmd("Markview enableAll");

This can also be used at runtime. So, you can hot-swap the config anytime you want!

Go ahead try running it.

---

You can configure the plugin in 2 ways,

📂 Presets

Presets are an easy way to change the looks of some part of the plugin.

Currently there are presets for the following items,

• Headings
• Tables

You can find more on presets on the wiki page.

🎨 Manual

The plugin was created with the sole purpose of being customisable.

So, you can change everything to fit your needs.

A simple example is given below,

require("markview").setup({
    headings = {
        enable = true,

        heading_1 = {
            style = "label",

            padding_left = " ",
            padding_right = " ",

            hl = "MarkviewHeading1"
        }
    }
});

You can check the wiki to learn more about configuration.

You can also check the Recipes for some simple examples.

🌃 highlight groups

To make configuration easier markview.nvim comes with the following highlight groups.

📦 Block quote

Block quotes have the following highlight group by default,

• MarkviewBlockQuoteDefault, also used by Quote, Cite.

Various callouts/alerts use the following highlight groups,

• MarkviewBlockQuoteOk, used by Tip, Hint, Success, Check, Done.
• MarkviewBlockQuoteWarn, used by Question, Help, Faq, Custom, Warning, Attention.
• MarkviewBlockQuoteError, used by Caution, Bug, Danger, Error, Failure, Fail, Missing.
• MarkviewBlockQuoteNote, used by Note, Todo, Info, Abstract, Summary, Tldr.
• MarkviewBlockQuoteSpecial, used Important, Example.

🎯 Checkboxes

Checkbox use these highlight groups,

• MarkviewCheckboxChecked, from DiagnosticOk.
• MarkviewCheckboxUnhecked, from DiagnosticError.
• MarkviewCheckboxPending, from DiagnosticWarn.

Markview also comes with 2 custom checkbox states,

Note

These are purely for custom notes and aren't taken from external tools(e.g. Obsidian).

• MarkviewCheckboxProgress, from Keyword. Checkboes using [~].

• MarkviewCheckboxCancelled, from Comment. Checkboxes using [o].

💻 Code blocks & inline codes

Code blocks use the following highlight group,

• MarkviewCode

Inline codes use the following highlight group,

• MarkviewInlineCode

🔖 Headings

Headings are highlighted with the following groups,

• MarkviewHeading1, from DiagnosticVirtualTextOk
• MarkviewHeading2, from DiagnosticVirtualTextHint
• MarkviewHeading3, from DiagnosticVirtualTextInfo
• MarkviewHeading4, from Special
• MarkviewHeading5, from DiagnosticVirtualTextWarn
• MarkviewHeading6, from DiagnosticVirtualTextError

Signs are highlighted with the following groups,

• MarkviewHeading1Sign, from DiagnosticOk
• MarkviewHeading2Sign, from DiagnosticHint
• MarkviewHeading3Sign, from DiagnosticInfo
• MarkviewHeading4Sign, from Special
• MarkviewHeading5Sign, from DiagnosticWarn
• MarkviewHeading6Sign, from DiagnosticError

📏 Horizontal rules

Horizontal rules use the following highlight groups for the gradient.

• MarkviewGradient1, from Normal.
• MarkviewGradient2
• MarkviewGradient3
• MarkviewGradient4
• MarkviewGradient5
• MarkviewGradient6
• MarkviewGradient7
• MarkviewGradient8
• MarkviewGradient9
• MarkviewGradient10, from Cursor.

🔗 Links

Links use the following highlight groups,

• MarkviewHyperlink, from markdownLinkText.
• MarkviewImageLink, from markdownLinkText.
• MarkviewEmail, from @markup.link.url.markdown_inline.

📝 List items

List items use the following highlight groups,

• MarkviewListItemMinus, from DiagnosticWarn.
• MarkviewListItemPlus, from DiagnosticOk.
• MarkviewListItemStar, from @comment.note.

📐 Tables

Tables use the following highlight group for the border,

• MarkviewTableBorder, from Title.

For the column alignment markers these highlight groups are used,

• MarkviewTableAlignLeft, from Title.
• MarkviewTableAlignRight, from Title.
• MarkviewTableAlignCenter, from Title.

⭐ Plugin showcase

_{Taken by @scottmckendry}