github github
star 77
alert-circle 1
open issues
users 3
git-branch 4



2 months ago


This plugin allows you evaluate code blocks inside markdown, vimwiki, orgmode.nvim and norg documents.

It attempts to implement the basic functionality of org-mode's evaluating code blocks feature inside Neovim.



This plugin requires Neovim version 0.5+.

It works on Linux, MacOS and Windows (through WSL).

MacOS users should make sure that they have coreutils package installed:

brew install coreutils

Windows users should have installed WSL with compilers/interpreters they want use.


Install it with your plugin manager.

Then add the following line in your init.lua:

require 'mdeval'.setup()

You should also enable syntax highlighting inside code blocks for your languages using the built-in functionality:

vim.g.markdown_fenced_languages = {'python', 'cpp'}


To use this plugin, you should move cursor inside a fenced code block with language identifier and execute the :MdEval command. mdeval.nvim will capture the results of the code block execution and inserts them in the markdown file, right after the code block.


You can configure mdeval.nvim by running the mdeval.setup function.

Here is an example:

require 'mdeval'.setup({
  -- Don't ask before executing code blocks
  -- Change code blocks evaluation options.
  eval_options = {
    -- Set custom configuration for C++
    cpp = {
      command = {"clang++", "-std=c++20", "-O0"},
      default_header = [[
    #include <iostream>
    #include <vector>
    using namespace std;
    -- Add new configuration for Racket
    racket = {
      command = {"racket"},        -- Command to run interpreter
      language_code = "racket",    -- Markdown language code
      exec_type = "interpreted",   -- compiled or interpreted
      extension = "rkt",           -- File extension for temporary files

By default, the plugin will ask your confirmation before evaluating code. This makes sense, because code evaluation is potentially harm operation. You can disable this feature setting require_confirmation option to false, or allow to execute code blocks without confirmation only for some languages, using allowed_file_types option, for example: allowed_file_types={'rust', 'haskell'}.

Probably, it will be a good idea to define keybindings to call :MdEval. This plugin doesn't add default keybindings, but you can do this in your configuration file, for example:

vim.api.nvim_set_keymap('n', '<leader>c',
                        "<cmd>lua require 'mdeval'.eval_code_block()<CR>",
                        {silent = true, noremap = true})

See the complete list of options in the documentation.

See also

  • Sniprun – A similar plugin written in Rust with much more features.