add default config

it conflicts with various plugins otherwise e.g. DevDocs

nvim/.config/nvim/lua/plugins/docs.lua

@@ -5,5 +5,30 @@ return {
 		"nvim-telescope/telescope.nvim",
 		"nvim-treesitter/nvim-treesitter",
 	},
-	opts = {},
+	opts = {
+		dir_path = vim.fn.stdpath("data") .. "/devdocs", -- installation directory
+		telescope = {}, -- passed to the telescope picker
+		filetypes = {
+			-- extends the filetype to docs mappings used by the `DevdocsOpenCurrent` command, the version doesn't have to be specified
+			-- scss = "sass",
+			-- javascript = { "node", "javascript" }
+		},
+		float_win = { -- passed to nvim_open_win(), see :h api-floatwin
+			relative = "editor",
+			height = 25,
+			width = 100,
+			border = "rounded",
+		},
+		wrap = false, -- text wrap, only applies to floating window
+		previewer_cmd = nil, -- for example: "glow"
+		cmd_args = {}, -- example using glow: { "-s", "dark", "-w", "80" }
+		cmd_ignore = {}, -- ignore cmd rendering for the listed docs
+		picker_cmd = false, -- use cmd previewer in picker preview
+		picker_cmd_args = {}, -- example using glow: { "-s", "dark", "-w", "50" }
+		mappings = { -- keymaps for the doc buffer
+			open_in_browser = "",
+		},
+		ensure_installed = {}, -- get automatically installed
+		after_open = function(bufnr) end, -- callback that runs after the Devdocs window is opened. Devdocs buffer ID will be passed in
+	},
 }

nvim/.config/nvim/lua/plugins/markdown.lua

@@ -0,0 +1,65 @@
+return {
+	"tadmccorkle/markdown.nvim",
+	ft = "markdown", -- or 'event = "VeryLazy"'
+	opts = {
+		-- Disable all keymaps by setting mappings field to 'false'.
+		-- Selectively disable keymaps by setting corresponding field to 'false'.
+		mappings = {
+			inline_surround_toggle = "gs", -- (string|boolean) toggle inline style
+			inline_surround_toggle_line = "gss", -- (string|boolean) line-wise toggle inline style
+			inline_surround_delete = "ds", -- (string|boolean) delete emphasis surrounding cursor
+			inline_surround_change = "cs", -- (string|boolean) change emphasis surrounding cursor
+			link_add = "gl", -- (string|boolean) add link
+			link_follow = "gx", -- (string|boolean) follow link
+			go_curr_heading = "]c", -- (string|boolean) set cursor to current section heading
+			go_parent_heading = "]p", -- (string|boolean) set cursor to parent section heading
+			go_next_heading = "]]", -- (string|boolean) set cursor to next section heading
+			go_prev_heading = "[[", -- (string|boolean) set cursor to previous section heading
+		},
+		inline_surround = {
+			-- For the emphasis, strong, strikethrough, and code fields:
+			-- * 'key': used to specify an inline style in toggle, delete, and change operations
+			-- * 'txt': text inserted when toggling or changing to the corresponding inline style
+			emphasis = {
+				key = "i",
+				txt = "*",
+			},
+			strong = {
+				key = "b",
+				txt = "**",
+			},
+			strikethrough = {
+				key = "s",
+				txt = "~~",
+			},
+			code = {
+				key = "c",
+				txt = "`",
+			},
+		},
+		link = {
+			paste = {
+				enable = true, -- whether to convert URLs to links on paste
+			},
+		},
+		toc = {
+			-- Comment text to flag headings/sections for omission in table of contents.
+			omit_heading = "toc omit heading",
+			omit_section = "toc omit section",
+			-- Cycling list markers to use in table of contents.
+			-- Use '.' and ')' for ordered lists.
+			markers = { "-" },
+		},
+		-- Hook functions allow for overriding or extending default behavior.
+		-- Called with a table of options and a fallback function with default behavior.
+		-- Signature: fun(opts: table, fallback: fun())
+		hooks = {
+			-- Called when following links. Provided the following options:
+			-- * 'dest' (string): the link destination
+			-- * 'use_default_app' (boolean|nil): whether to open the destination with default application
+			--   (refer to documentation on <Plug> mappings for explanation of when this option is used)
+			follow_link = nil,
+		},
+		on_attach = nil, -- (fun(bufnr: integer)) callback when plugin attaches to a buffer
+	},
+}

nvim/.config/nvim/lua/plugins/treesitter.lua

@@ -1,7 +1,6 @@
 return { -- Highlight, edit, and navigate code
 	"nvim-treesitter/nvim-treesitter",
 	dependencies = {
-		"tadmccorkle/markdown.nvim",
 		"nvim-treesitter/nvim-treesitter-context",
 		"nvim-treesitter/nvim-treesitter-textobjects",
 		"windwp/nvim-ts-autotag",
@@ -18,10 +17,6 @@ return { -- Highlight, edit, and navigate code
 			--  the list of additional_vim_regex_highlighting and disabled languages for indent.
 			additional_vim_regex_highlighting = { "ruby" },
 		},
-		markdown = {
-			enable = true, -- must be specified to enable markdown.nvim as a module
-			-- configuration here or nothing for defaults
-		},
 		indent = { enable = true, disable = { "ruby" } },
 		autotag = {
 			enable = true,