diff --git a/init.lua b/init.lua
index ebbfe9ec..7e9dd5b1 100644
--- a/init.lua
+++ b/init.lua
@@ -339,25 +339,23 @@ require('lazy').setup({
   },
 })
 
--- I should put this somewhere else later, but this allows for collapsing folds.
+-- I should put all this config somewhere else later
+-- this allows for collapsing folds.
 vim.opt.foldmethod = 'expr'
 vim.opt.foldexpr = 'nvim_treesitter#foldexpr()'
 vim.opt.foldlevelstart = 99
-
+-- relative line numbers and line numbers
 vim.opt.nu = true
 vim.opt.relativenumber = true
-
+-- tabbing options
 vim.opt.tabstop = 4
 vim.opt.softtabstop = 4
 vim.opt.shiftwidth = 4
 vim.opt.expandtab = true
-
 vim.opt.smartindent = true
-
+-- this is transparent background
 vim.api.nvim_set_hl(0, 'Normal', { bg = 'none' })
 vim.api.nvim_set_hl(0, 'NormalFloat', { bg = 'none' })
 
-vim.keymap.set('n', '<leader>dt', ':DocsViewToggle<enter>', { desc = 'Toggle Documentation' })
-vim.keymap.set('n', '-', '<CMD>Oil<CR>', { desc = 'Open parent directory' })
 -- The line beneath this is called `modeline`. See `:help modeline`
 -- vim: ts=2 sts=2 sw=2 et
diff --git a/lua/custom/plugins/oil.lua b/lua/custom/plugins/oil.lua
index 0395d2bd..39089d8f 100644
--- a/lua/custom/plugins/oil.lua
+++ b/lua/custom/plugins/oil.lua
@@ -1,6 +1,30 @@
 return {
   'stevearc/oil.nvim',
-  opts = {},
+  opts = {
+    columns = {
+      'icon',
+      -- "permissions",
+      'size',
+      'mtime',
+    },
+  },
+  keymaps = {
+    ['g?'] = 'actions.show_help',
+    ['<CR>'] = 'actions.select',
+    ['<C-s>'] = { 'actions.select', opts = { vertical = true }, desc = 'Open the entry in a vertical split' },
+    ['<C-t>'] = { 'actions.select', opts = { tab = true }, desc = 'Open the entry in new tab' },
+    ['<C-p>'] = 'actions.preview',
+    ['<C-c>'] = 'actions.close',
+    ['-'] = 'actions.parent',
+    ['_'] = 'actions.open_cwd',
+    ['`'] = 'actions.cd',
+    ['~'] = { 'actions.cd', opts = { scope = 'tab' }, desc = ':tcd to the current oil directory' },
+    ['gs'] = 'actions.change_sort',
+    ['gx'] = 'actions.open_external',
+    ['g.'] = 'actions.toggle_hidden',
+    ['g\\'] = 'actions.toggle_trash',
+  },
+  use_default_keymaps = false,
   -- Optional dependencies
   dependencies = { 'echasnovski/mini.icons' },
   -- dependencies = { "nvim-tree/nvim-web-devicons" }, -- use if prefer nvim-web-devicons
diff --git a/lua/kickstart/plugins/doc_view.lua b/lua/kickstart/plugins/doc_view.lua
index 3f734b4c..41886dd9 100644
--- a/lua/kickstart/plugins/doc_view.lua
+++ b/lua/kickstart/plugins/doc_view.lua
@@ -6,4 +6,12 @@ return {
     position = 'right',
     width = 60,
   },
+  keys = {
+    {
+      '<leader>dt',
+      ':DocsViewToggle<enter>',
+      desc = 'Toggle Documentation',
+      mode = { 'n' },
+    },
+  },
 }
diff --git a/lua/kickstart/plugins/lint.lua b/lua/kickstart/plugins/lint.lua
index 7f0dc42f..f22236e9 100644
--- a/lua/kickstart/plugins/lint.lua
+++ b/lua/kickstart/plugins/lint.lua
@@ -35,7 +35,7 @@ return {
       -- lint.linters_by_ft['inko'] = nil
       -- lint.linters_by_ft['janet'] = nil
       -- lint.linters_by_ft['json'] = nil
-      -- lint.linters_by_ft['markdown'] = nil
+      lint.linters_by_ft['markdown'] = nil
       -- lint.linters_by_ft['rst'] = nil
       -- lint.linters_by_ft['ruby'] = nil
       -- lint.linters_by_ft['terraform'] = nil