Oncomouse's markdown.nvim plugin

This plugin combines a few features from other plugins while removing features I don't use:

1. The ability to do syntax-aware join (J and gJ) and newline (o and O).
   • Newline supports extending block quotes and lists (both ordered and unordered).
   • Join will remove syntax when joining lines.
2. Smart detab/tab:
   • In insert mode, <C-t> and <C-d> will auto-increment ordered lists; <C-d> with no whitespace will delete list marker
   • In normal mode, >, >>, <, and << will auto-increment ordered lists; < and << with no whitespace will delete list marker
3. Smart delete: using dd or d<motion> will automatically trigger renumbering of ordered lists
4. All of the motion commands from vim-markdown.
5. Switch list type:
   • In insert mode, <C-Z> will switch list type for the current line
   • In normal mode, <leader>mss will switch list type for the current list
     • <leader>ms will use operatorfunc to switch list type for a given motion
6. Renumber:
   • In normal mode, <leader>mn will renumber an ordered list

Configuring

Running require("markdown").setup() will create the necessary mappings in any buffer. By default, this loads for all markdown files, but you could use autocommands or other ftplugins to load the mappings elsewhere.

Several variables control the plugin's behavior:

• vim.g.markdown_nvim_modules -- Define the modules to load (default: { "markdown.detab", "markdown.join", "markdown.movements", "markdown.newline", "markdown.renumber", "markdown.switch", })
  • vim.b.markdown_nvim_modules -- Load modules for a particular buffer
• vim.g.markdown_nvim_unordered_default -- Define the unordered token to use when switching ordered lists to unordered (default: *)
  • vim.b.markdown_nvim_unordered_default -- Set for individual buffers
• vim.g.markdown_nvim_do_not_set_default_maps -- Set to true or 1 to prevent the creation of default mappings.
  • vim.b.markdown_nvim_do_not_set_default_maps -- Disable default maps for an individual buffer

Autopairs Support for markdown.nvim

This plugin does not insert list or blockquote characters on newline. Lists can be managed using autolist.nvim; block quotes might be extending using any of the available autopairs plugins.

I use lexima.vim for autopairs, and the following rules supplement this plugin:

-- Blockquotes:
vim.fn["lexima#add_rule"]({
    char = "<BS>",
    input = "<BS><BS>",
    at = [[^> \%#]],
    filetype = "markdown",
})
vim.fn["lexima#add_rule"]({
    char = "<CR>",
    at = [[^> .\+\%#$]],
    input = "<CR>> ",
    filetype = "markdown",
})
vim.fn["lexima#add_rule"]({
    char = "<CR>",
    at = [[^> \%#$]],
    input = "<BS><BS><CR>",
    filetype = "markdown",
})
vim.fn["lexima#add_rule"]({
    char = ">",
    input = "> ",
    at = [[^\%#]],
    filetype = "markdown",
})
-- Unordered Lists:
vim.fn["lexima#add_rule"]({
    char = "<CR>",
    at = [[^\s*\([*-]\).*\%#$]],
    filetype = "markdown",
    with_submatch = true,
    input = [[<CR>\1 ]],
    except = [[^\s*\([*-]\) \%#$]],
})
vim.fn["lexima#add_rule"]({
    char = "<CR>",
    at = [[^\s*[*-] \%#$]],
    filetype = "markdown",
    input = [[<Home><C-O>"_D<CR>]],
})
vim.fn["lexima#add_rule"]({
    char = "<BS>",
    at = [[^\(\s*\)[*-] \%#$]],
    filetype = "markdown",
    with_submatch = true,
    input = [[<Home><C-O>"_D\1]],
})
-- Ordered Lists (including automatic increment):
vim.fn["lexima#add_rule"]({
    char = "<CR>",
    at = [[^\s*\([0-9]\+\)\..*\%#$]],
    filetype = "markdown",
    with_submatch = true,
    input = [[<CR>\1. <Home><C-O>:exec "normal! \<c-a\>" "$"<CR>]],
    except = [[^\s*\([0-9]\)\. \%#$]],
})
vim.fn["lexima#add_rule"]({
    char = "<CR>",
    at = [[^\s*[0-9]\+\. \%#$]],
    filetype = "markdown",
    input = [[<Home><C-O>"_D<CR>]],
})
vim.fn["lexima#add_rule"]({
    char = "<BS>",
    at = [[^\(\s*\)[0-9]\+\. \%#$]],
    filetype = "markdown",
    with_submatch = true,
    input = [[<Home><C-O>"_D\1]],
})

Todo

1. Binding to switch list type (from ordered to unordered).
2. Binding to recalculate numbering for ordered lists
3. Detab properly renumbers ordered lists
4. Tab binding to properly renumber ordered lists
5. Increment numbers on new ordered list
6. Tab support for renumbering in normal mode (>>)
7. Tab/detab with operator-pending support (>) for renumbering
8. Delete module operator-pending support
9. Visual delete
10. Paste (p/P) support
11. Visual paste (p/P) support
12. o/O detect when line below/above is a list but current line isn't
13. vim.v.count1 support for opfunc-based delete
14. Follow footnotes (references / definitions)
15. Follow footnotes outside of current file
16. Follow footnote definitions outside of current file
17. Update all of this to work with orgmode