This is a fork of the original symbols-outline.nvim which fixed a lot of bugs from the original repo, and also added many more features.
You can see all the changes from the original plugin before v1.0.0 in #12 on github.
It started out as a personal fork which I maintain for my personal use-cases, soon more and more features found their way in and I started introducing significant changes.
However, due to simrat's status with the original plugin, I eventually decided to rename and detach the fork, starting to work on this as a new plugin.
If you have existing setup opts for symbols-outline.nvim, you can convert it to be usable for outline.nvim using this script: scripts/convert-symbols-outline-opts.lua.
A sidebar with a tree-like outline of symbols from your code, powered by LSP.
outline_2023-11-19.mp4
A note to sourcehut viewers: a GIF version is coming soon!
Table of contents
- Prerequisites
- Installation
- Setup
- Configuration
- Providers
- Commands
- Default keymaps
- Highlights
- Lua API
- Tips
- Recipes
- TODO
- Limitations
- Related plugins
- Neovim 0.7+
- To use modifiers on commands, Neovim 0.8 is required. Everything else works with Neovim 0.7.
- To use outline.nvim with LSP, a properly configured LSP client is required.
- GitHub repo:
"hedyhli/outline.nvim"
- Or SourceHut repo:
url = "https://git.sr.ht/~hedy/outline.nvim"
(an equivalent key tourl
for your plugin manager)
Lazy.nvim example:
{
"hedyhli/outline.nvim",
config = function()
-- Example mapping to toggle outline
vim.keymap.set("n", "<leader>tt", "<cmd>Outline<CR>",
{ desc = "Toggle Outline" })
require("outline").setup {
-- Your setup opts here (leave empty to use defaults)
}
end,
},
Lazy.nvim with lazy-loading example:
{
"hedyhli/outline.nvim",
lazy = true,
cmd = { "Outline", "OutlineOpen" },
keys = { -- Example mapping to toggle outline
{ "<leader>tt", "<cmd>Outline<CR>", desc = "Toggle outline" },
},
opts = {
-- Your setup opts here
},
},
This allows Lazy.nvim to lazy-load the plugin on commands Outline
,
OutlineOpen
, and your keybindings.
Call the setup function with your configuration options.
Note that a call to .setup()
is required for this plugin to work
(otherwise you might see this error: simrat39/symbols-outline.nvim#213).
require("outline").setup({})
The configuration structure has been heavily improved and refactored in this plugin. If you're migrating from the original symbols-outline, see #12 on github under "breaking changes" section.
Check this list if you have any confusion with the terms used in the configuration.
- Provider: Source of the items in the outline view. Could be LSP, CoC, etc.
- Node: An item in the outline view
- Fold: Collapse a collapsible node
- Location: Where in the source file a node is from
- Preview: Show the location of a node in code using a floating window. Syntax highlighting is provided if treesitter is installed.
- Jump/Peek: Go to corresponding location in code without leaving outline window
- Hover: Cursor currently on the line of a node
- Hover symbol: Displaying a floating window to show symbol information provided by provider.
- Focus: Which window the cursor is in
Pass a table to the setup call with your configuration options.
Show defaults
{
outline_window = {
-- Where to open the split window: right/left
position = 'right',
-- The default split commands used are 'topleft vs' and 'botright vs'
-- depending on `position`. You can change this by providing your own
-- `split_command`.
-- `position` will not be considered if `split_command` is non-nil.
-- This should be a valid vim command used for opening the split for the
-- outline window. Eg, 'rightbelow vsplit'.
split_command = nil,
-- Percentage or integer of columns
width = 25,
-- Whether width is relative to the total width of nvim
-- When relative_width = true, this means take 25% of the total
-- screen width for outline window.
relative_width = true,
-- Auto close the outline window if goto_location is triggered and not for
-- peek_location
auto_close = false,
-- Automatically scroll to the location in code when navigating outline window.
auto_jump = false,
-- boolean or integer for milliseconds duration to apply a temporary highlight
-- when jumping. false to disable.
jump_highlight_duration = 300,
-- Whether to center the cursor line vertically in the screen when
-- jumping/focusing. Executes zz.
center_on_jump = true,
-- Vim options for the outline window
show_numbers = false,
show_relative_numbers = false,
wrap = false,
-- true/false/'focus_in_outline'/'focus_in_code'.
-- The last two means only show cursorline when the focus is in outline/code.
-- 'focus_in_outline' can be used if the outline_items.auto_set_cursor
-- operations are too distracting due to visual contrast caused by cursorline.
show_cursorline = true,
-- Enable this only if you enabled cursorline so your cursor color can
-- blend with the cursorline, in effect, as if your cursor is hidden
-- in the outline window.
-- This makes your line of cursor have the same color as if the cursor
-- wasn't focused on the outline window.
-- This feature is experimental.
hide_cursor = false,
-- Whether to auto-focus on the outline window when it is opened.
-- Set to false to *always* retain focus on your previous buffer when opening
-- outline.
-- If you enable this you can still use bangs in :Outline! or :OutlineOpen! to
-- retain focus on your code. If this is false, retaining focus will be
-- enforced for :Outline/:OutlineOpen and you will not be able to have the
-- other behaviour.
focus_on_open = true,
-- Winhighlight option for outline window.
-- See :help 'winhl'
-- To change background color to "CustomHl" for example, use "Normal:CustomHl".
winhl = '',
},
outline_items = {
-- Show extra details with the symbols (lsp dependent) as virtual next
show_symbol_details = true,
-- Show corresponding line numbers of each symbol on the left column as
-- virtual text, for quick navigation when not focused on outline.
-- Why? See this comment:
-- https://github.com/simrat39/symbols-outline.nvim/issues/212#issuecomment-1793503563
show_symbol_lineno = false,
-- Whether to highlight the currently hovered symbol and all direct parents
highlight_hovered_item = true,
-- Whether to automatically set cursor location in outline to match
-- location in code when focus is in code. If disabled you can use
-- `:OutlineFollow[!]` from any window or `<C-g>` from outline window to
-- trigger this manually.
auto_set_cursor = true,
-- Autocmd events to automatically trigger these operations.
auto_update_events = {
-- Includes both setting of cursor and highlighting of hovered item.
-- The above two options are respected.
-- This can be triggered manually through `follow_cursor` lua API,
-- :OutlineFollow command, or <C-g>.
follow = { 'CursorMoved' },
-- Re-request symbols from the provider.
-- This can be triggered manually through `refresh_outline` lua API, or
-- :OutlineRefresh command.
items = { 'InsertLeave', 'WinEnter', 'BufEnter', 'BufWinEnter', 'TabEnter', 'BufWritePost' },
},
},
-- Options for outline guides which help show tree hierarchy of symbols
guides = {
enabled = true,
markers = {
-- It is recommended for bottom and middle markers to use the same number
-- of characters to align all child nodes vertically.
bottom = '└',
middle = '├',
vertical = '│',
},
},
symbol_folding = {
-- Depth past which nodes will be folded by default
autofold_depth = nil,
-- When to auto unfold nodes
auto_unfold = {
-- Auto unfold currently hovered symbol
hovered = true,
-- Auto fold when the root level only has this many nodes.
-- Set true for 1 node, false for 0.
only = true,
},
markers = { '', '' },
},
preview_window = {
-- Automatically open preview of code location when navigating outline window
auto_preview = false,
-- Automatically open hover_symbol when opening preview (see keymaps for
-- hover_symbol).
-- If you disable this you can still open hover_symbol using your keymap
-- below.
open_hover_on_preview = false,
width = 50, -- Percentage or integer of columns
min_width = 50, -- This is the number of columns
-- Whether width is relative to the total width of nvim.
-- When relative_width = true, this means take 50% of the total
-- screen width for preview window, ensure the result width is at least 50
-- characters wide.
relative_width = true,
-- Border option for floating preview window.
-- Options include: single/double/rounded/solid/shadow or an array of border
-- characters.
-- See :help nvim_open_win() and search for "border" option.
border = 'single',
-- winhl options for the preview window, see ':h winhl'
winhl = 'NormalFloat:',
-- Pseudo-transparency of the preview window, see ':h winblend'
winblend = 0
},
-- These keymaps can be a string or a table for multiple keys.
-- Set to `{}` to disable. (Using 'nil' will fallback to default keys)
keymaps = {
show_help = '?',
close = {'<Esc>', 'q'},
-- Jump to symbol under cursor.
-- It can auto close the outline window when triggered, see
-- 'auto_close' option above.
goto_location = '<Cr>',
-- Jump to symbol under cursor but keep focus on outline window.
peek_location = 'o',
-- Visit location in code and close outline immediately
goto_and_close = '<S-Cr>',
-- Change cursor position of outline window to match current location in code.
-- 'Opposite' of goto/peek_location.
restore_location = '<C-g>',
-- Open LSP/provider-dependent symbol hover information
hover_symbol = '<C-space>',
-- Preview location code of the symbol under cursor
toggle_preview = 'K',
rename_symbol = 'r',
code_actions = 'a',
-- These fold actions are collapsing tree nodes, not code folding
fold = 'h',
unfold = 'l',
fold_toggle = '<Tab>',
-- Toggle folds for all nodes.
-- If at least one node is folded, this action will fold all nodes.
-- If all nodes are folded, this action will unfold all nodes.
fold_toggle_all = '<S-Tab>',
fold_all = 'W',
unfold_all = 'E',
fold_reset = 'R',
-- Move down/up by one line and peek_location immediately.
-- You can also use outline_window.auto_jump=true to do this for any
-- j/k/<down>/<up>.
down_and_jump = '<C-j>',
up_and_jump = '<C-k>',
},
providers = {
priority = { 'lsp', 'coc', 'markdown', 'norg' },
lsp = {
-- Lsp client names to ignore
blacklist_clients = {},
},
},
symbols = {
-- Filter by kinds (string) for symbols in the outline.
-- Possible kinds are the Keys in the icons table below.
-- A filter list is a string[] with an optional exclude (boolean) field.
-- The symbols.filter option takes either a filter list or ft:filterList
-- key-value pairs.
-- Put exclude=true in the string list to filter by excluding the list of
-- kinds instead.
-- Include all except String and Constant:
-- filter = { 'String', 'Constant', exclude = true }
-- Only include Package, Module, and Function:
-- filter = { 'Package', 'Module', 'Function' }
-- See more examples below.
filter = nil,
-- You can use a custom function that returns the icon for each symbol kind.
-- This function takes a kind (string) as parameter and should return an
-- icon as string.
icon_fetcher = nil,
-- 3rd party source for fetching icons. Fallback if icon_fetcher returned
-- empty string. Currently supported values: 'lspkind'
icon_source = nil,
-- The next fallback if both icon_fetcher and icon_source has failed, is
-- the custom mapping of icons specified below. The icons table is also
-- needed for specifying hl group.
icons = {
File = { icon = '', hl = 'Identifier' },
Module = { icon = '', hl = 'Include' },
Namespace = { icon = '', hl = 'Include' },
Package = { icon = '', hl = 'Include' },
Class = { icon = '𝓒', hl = 'Type' },
Method = { icon = 'ƒ', hl = 'Function' },
Property = { icon = '', hl = 'Identifier' },
Field = { icon = '', hl = 'Identifier' },
Constructor = { icon = '', hl = 'Special' },
Enum = { icon = 'ℰ', hl = 'Type' },
Interface = { icon = '', hl = 'Type' },
Function = { icon = '', hl = 'Function' },
Variable = { icon = '', hl = 'Constant' },
Constant = { icon = '', hl = 'Constant' },
String = { icon = '𝓐', hl = 'String' },
Number = { icon = '#', hl = 'Number' },
Boolean = { icon = '⊨', hl = 'Boolean' },
Array = { icon = '', hl = 'Constant' },
Object = { icon = '⦿', hl = 'Type' },
Key = { icon = '🔐', hl = 'Type' },
Null = { icon = 'NULL', hl = 'Type' },
EnumMember = { icon = '', hl = 'Identifier' },
Struct = { icon = '𝓢', hl = 'Structure' },
Event = { icon = '🗲', hl = 'Type' },
Operator = { icon = '+', hl = 'Identifier' },
TypeParameter = { icon = '𝙏', hl = 'Identifier' },
Component = { icon = '', hl = 'Function' },
Fragment = { icon = '', hl = 'Constant' },
TypeAlias = { icon = ' ', hl = 'Type' },
Parameter = { icon = ' ', hl = 'Identifier' },
StaticMethod = { icon = ' ', hl = 'Function' },
Macro = { icon = ' ', hl = 'Function' },
},
},
}
To find out exactly what some of the options do, please see the recipes section at the bottom for screen-recordings/shots.
filter
Include all symbols except kinds String and Variable:
symbols.filter = { 'String', 'Variable', exclude=true }
Include only Function symbols:
symbols.filter = { 'Function' }
Per-filetype filtering example:
- For python, only include function and class
- For other file types, include all but string
symbols.filter = {
default = { 'String', exclude=true },
python = { 'Function', 'Class' },
}
Note how the python filter list and the default filter list is NOT merged.
Setting any filter list to nil
or false
means include all symbols, where a
filter list is an array of strings with an optional exclude
field.
icons
The order in which the sources for icons are checked is:
- Icon fetcher function
- Icon source (only
lspkind
is supported for this option as of now) - Icons table
A fallback is always used if the previous candidate returned a falsey value.
The current list of tested providers are:
- LSP (requires a suitable LSP server to be configured for the requested buffer)
- For JSX support,
javascript
parser for treesitter is required
- For JSX support,
- Markdown (no external requirements)
- Norg (requires
norg
parser for treesitter)
External providers can be appended to the providers.priority
list. Each
item in the list is appended to "outline.providers.<item>"
to form an import
path, for use as a provider.
External providers from plugins should define the provider module at
lua/outline/providers/<name>.lua
with these functions:
-
supports_buffer(bufnr: integer) -> boolean
This function could check buffer filetype, existence of required modules, etc.
-
get_status() -> string[]
(optional)Return a list of lines to be included in
:OutlineStatus
as supplementary information when this provider is active.See an example of this function in the LSP provider.
-
request_symbols(callback: function, opts: table)
- param
callback
is a function that receives a list of symbols and theopts
table. - param
opts
can be passed tocallback
without processing
Each symbol table in the list of symbols should these fields:
- name: string
- kind: integer
- selectionRange: table with fields
start
andend
, each have fieldsline
andcharacter
, each integers - range: table with fields
start
andend
, each have fieldsline
andcharacter
, each integers - children: list of table of symbols
- detail: (optional) string, shown as
outline_items.show_symbol_details
- param
The built-in markdown provider is a good example of a very simple outline-provider module which parses raw buffer lines and uses regex; the built-in norg provider is an example which uses treesitter.
All providers should support at least nvim 0.7. You can make use of
_G._outline_nvim_has
with fields [8]
and [9]
equivalent to
vim.fn.has('nvim-0.8) == 1
and vim.fn.has('nvim-0.9) == 1
respectively.
If a higher nvim version is required, it is recommended to check for this
requirement in the supports_buffer
function.
-
:Outline[!] (✓ bang ✓ mods)
Toggle outline. With bang (
!
) the cursor focus stays in your original window after opening the outline window. Setfocus_on_open = true
to always use this behaviour.You can use command modifiers
topleft
/aboveleft
/botright
/belowright
on this command to control how the outline window split is created. Other modifiers are ignored.Example:
" in config: position='right'
:topleft Outline " opens with 'topleft vsplit'
:belowright Outline " opens with 'belowright vsplit'
:Outline " opens with 'botright vsplit'
-
:OutlineOpen[!] (✓ bang ✓ mods)
Open outline. With bang (
!
) the cursor focus stays in your original window after opening the outline window. Setfocus_on_open = true
to always use this behaviour.You can use command modifiers
topleft
/aboveleft
/botright
/belowright
on this command to control how the outline window split is created. Other modifiers are ignored.
" in config: position='left'
:aboveleft OutlineOpen " opens with 'aboveleft vsplit'
:belowright OutlineOpen " opens with 'belowright vsplit'
:OutlineOpen " opens with 'topleft vsplit'
-
:OutlineClose: Close outline
-
:OutlineFocus: Toggle focus between outline and code/source window
-
:OutlineFocusOutline: Focus on outline
-
:OutlineFocusCode: Focus on source window
-
:OutlineStatus: Display provider and outline window status in a floating window, similar to
:LspInfo
-
:OutlineFollow[!] (✓ bang × mods)
Go to corresponding node in outline based on cursor position in code, and focus on the outline window.
With bang (
!
), retain focus on the code window.This can be understood as the converse of
goto_location
(see keymaps).goto_location
sets cursor of code window to the position of outline window, whereas this command sets position in outline window to the cursor position of code window.With bang, it can be understood as the converse of
peek_location
.This is automatically triggered on events
outline_items.auto_update_events.follow
.You can also trigger this manually using the
restore_location
keymap (default<C-g>
) from the outline window. -
:OutlineRefresh
Trigger refresh of symbols from provider and update outline items.
This is automatically triggered on events
outline_items.auto_update_events.refresh
.
These mappings are active only for the outline window.
You can open a floating window showing the following list of keymaps using the ?
key by default from the outline window.
Key | Action |
---|---|
Esc / q | Close outline |
Enter | Go to symbol location in code |
o | Go to symbol location in code without losing focus |
Shift+Enter | Go to symbol location in code and close outline |
Ctrl+g | Update outline window to focus on code location |
K | Toggles the current symbol preview |
Ctrl+Space | Hover current symbol (provider action) |
r | Rename symbol |
a | Code actions |
h | Fold symbol or parent symbol |
Tab | Toggle fold under cursor |
Shift+Tab | Toggle all folds |
l | Unfold symbol |
W | Fold all symbols |
E | Unfold all symbols |
R | Reset all folding |
Ctrl+k | Go up and peek location |
Ctrl+j | Go down and peek location |
? | Show current keymaps in a floating window |
Default:
outline_window = {
winhl = '',
},
Possible highlight groups for the outline window:
Highlight | Description |
---|---|
OutlineCurrent | Current symbol under cursor |
OutlineGuides | Guide markers section in each line of the outline |
OutlineFoldMarker | Fold markers in the outline |
OutlineDetails | Symbol details in virtual text |
OutlineLineno | The Lineno column virtual text |
You can customize any other highlight groups using winhl
, this option is
passed directly to the winhl
vim option unprocessed.
If any of the above highlights have not already been set before outline.setup is called (say by a theme), the following links are used:
Highlight | Link |
---|---|
OutlineGuides | Comment |
OutlineFoldMarker | Normal |
OutlineDetails | Comment |
OutlineLineno | LineNr |
For OutlineCurrent
, foreground is set to String and background CursorLine.
To customize colors of the symbol icons, use the symbols.icons
table. See
config.
preview_window = {
winhl = 'NormalFloat:',
},
Highlight | Description |
---|---|
OutlineJumpHighlight | Indicating cursor position when jumping/focusing, defaults to Visual |
You can also use outline_window.jump_highlight_duration
to customize in milliseconds,
how long the highlight is applied for.
Outline.nvim provides the following public API for use in lua.
require'outline'
-
setup(opts)
-
toggle_outline(opts)
Toggle opening/closing of outline window.
If
opts.focus_outline=false
, keep focus on previous window. -
open_outline(opts)
Open the outline window.
If
opts.focus_outline=false
, keep focus on previous window. -
close_outline()
Close the outline window.
-
focus_toggle()
Toggle cursor focus between code and outline window.
-
focus_outline()
Focus cursor on the outline window.
-
focus_code()
Focus cursor on the window which the outline is derived from.
-
is_open()
Return whether the outline window is open.
-
show_status()
Display provider and outline window status in a floating window.
-
has_provider()
Returns whether a provider is available for current window.
-
follow_cursor(opts)
Go to corresponding node in outline based on cursor position in code, and focus on the outline window.
With
opts.focus_outline=false
, cursor focus will remain on code window.This is automatically called on events
outline_items.auto_update_events.follow
from config. -
is_focus_in_outline()
Return whether outline is open and current focus is in outline.
-
refresh_outline()
Re-request symbols from provider and update outline items.
This is automatically called on events
outline_items.auto_update_events.refresh
from config.
-
To open the outline but don't focus on it, you can use
:Outline!
or:OutlineOpen!
.This is useful in autocmds, say you have a filetype that, whenever a buffer with that filetype is opened you want to open the outline.
-
After navigating around in the outline window, you can use
<C-g>
(default mapping forrestore_location
) to go back to the corresponding outline location based on the code location. -
To customize the background colors, text colors, and borders, you can use
outline_window.winhl
for the outline window orpreview_window.winhl
for the preview floating window. See highlights. -
To fix symbol icon related issues, there are several options. If you use
lspkind
, you can setsymbols.icon_source = 'lspkind'
to use lspkind for fetching icons. You can also use your own functionsymbols.icon_fetcher
that takes a string and should return an icon. Otherwise, you can edit thesymbols.icons
table for specifying icons.The order in which the sources of icons are checked is:
- Icon fetcher function
- Icon source
- Icons table
A fallback is always used if the previous candidate returned falsey value.
You can hide an icon for a specific type by returning
""
.Below is an example where icons are disabled for kind 'Package', and for other icons use lspkind.
symbols = {
icon_fetcher = function(k)
if k == 'Package' then
return ""
end
return false
end,
icon_source = 'lspkind',
}
-
You can customize the split command used for creating the outline window split using
outline_window.split_command
, such as"topleft vsp"
. See:h windows
-
Is the outline window too slow when first opening a file? This is usually due to the LSP not being ready when you open outline, hence we have to wait for the LSP response before the outline can be shown. If LSP is ready generally the outline latency is almost negligible.
Behaviour you may want to achieve and the combination of configuration options to achieve it.
Code snippets in this section are to be placed in .setup({ <HERE> })
directly
unless specified otherwise.
Unfold all others except currently hovered item.
symbol_folding = {
autofold_depth = 1,
auto_unfold = {
hovered = true,
},
},
symbol_folding = {
auto_unfold = {
only = 2,
},
},
auto_unfold.only = 2
:
outline_autounfold_2.mp4
auto_unfold.only = 1
:
outline_autounfold_1.mp4
In words "auto unfold nodes when there is only 2 nodes shown in the outline."
For auto_unfold.only = true
: "auto unfold nodes when the root node is the only node left visible in the outline."
Use outline window as a quick-jump window
preview_window = {
auto_preview = true,
},
so_auto_preview.mov
Alternatively, if you want to automatically navigate to the corresponding code location directly and not use the preview window:
outline_window = {
auto_jump = true,
},
so_auto_goto.mov
Or, you can use keys <C-j>
and <C-k>
to achieve the same effect, whilst not
having auto_jump
on by default.
Hide the extra details after each symbol name
outline_items = {
show_symbol_details = false,
},
You can customize its highlight group by setting OutlineDetails
in
outline_window.winhl
.
Show line numbers next to each symbol to jump to that symbol quickly
outline_items = {
show_symbol_lineno = true,
},
The default highlight group for the line numbers is LineNr
, you can customize
it using outline_window.winhl
: please see highlights.
Hide the cursor within cursorline. This setting changes the cursor color to be
that of Cursorline
when focus is in outline window. As of now guicursor
is
a global option, so outline.nvim has to set and reset responsibly hence this
feature may be unstable. You can inspect
require('outline').state.original_cursor
and set guicursor
accordingly,
though you should almost never need to do this.
outline_window = {
show_cursorline = true,
hide_cursor = true,
}
This will be how the outline window looks like when focused:
Some may find this unhelpful, but one may argue that elements in each row of the outline becomes more readable this way, hence this is an option.
You can write your own function for fetching icons. Here is one such example that simply returns in plain text, the first letter of the given kind.
symbols = {
icon_fetcher = function(kind) return kind:sub(1,1) end
}
The fetcher function, if provided, is checked first before using icon_source
and icons
as fallback.
Disable all icons:
symbols = {
icon_fetcher = function(_) return "" end,
}
Disable icons for specific kinds, and for others use lspkind:
symbols = {
icon_fetcher = function(k)
if k == 'String' then
return ""
end
return false
end,
icon_source = 'lspkind',
}
Any other recipes you think others may also find useful? Feel free to open a PR.
Key:
- : Idea
- [ ] : Planned
- [/] : WIP
- ❌ : Was idea, found usable workaround
- ✅ : Implemented
-
Folds
[ ]
Org-like shift+tab behavior: Open folds level-by-level[ ]
Optionally not opening all child nodes when opening parent node- Fold siblings and siblings of parent on startup
-
Navigation
- ❌ Go to parent (as of now you can press
hl
to achieve the same effect) - ❌ Cycle siblings (as of now when reached the last sibling, you can use
hlj
to go back to first sibling)
- ❌ Go to parent (as of now you can press
-
[ ]
simrat39/symbols-outline.nvim#75: Handling of the outline window when attached buffer is closed.Maybe it should continue working, so that pressing enter can open a split to the correct location like
NvimTree
does, and pressingq
can properly close the buffer.
Sometimes the preview window could be slow in loading. This could be due to the code buffer being large. As of now there are no good solutions in circumventing this problem — currently the entire code buffer is read, and then put into the preview buffer. If only the required portion to preview is read and set instead, there would be highlighting issues (say the calculated starting line was within a markdown code block, so what was previously not supposed to be code is now highlighted as code).
Outline.nvim does not support having multiple outlines attached to different buffers as of now. However, this feature is planned, and for now you can use a single outline sidebar and have it auto-update whenever you switch buffers.
- Aerial.nvim
- nvim-navic
- nvim-navbuddy
- dropdown.nvim
- treesitter (inspect/edit)
- lspsaga
- navigator.lua