gh-liu/fold_line.nvim

github

formattingindent

56

1

2

0

CREATED

2024-06-21

UPDATED

2026-03-08

---

fold_line.nvim

This Neovim plugin uses lines to indicate code folding areas and highlights the current fold.

Screenshots

The line of the current fold is yellow. You can change the color by setting the FoldLineCurrent highlight group.

Installation

Using lazy.nvim

-- init.lua:
{
    "gh-liu/fold_line.nvim",
    event = "VeryLazy",
    init = function()
        -- change the char of the line, see the `Appearance` section
        vim.g.fold_line_char_open_start = "╭"
        vim.g.fold_line_char_open_end = "╰"
    end,
}

Appearance

Use the highlight group FoldLine to change the color of the line. Per default it links to Folded. And use the highlight group FoldLineCurrent to change the color of the line of current fold. Per default it links to CursorLineFold.

change the char of the line:

vim.g.fold_line_char_top_close = "+"        -- default: fillchars.foldclose or "+"
vim.g.fold_line_char_close = "├"            -- default: fillchars.vertright or "├"
vim.g.fold_line_char_open_sep = "│"         -- default: fillchars.foldsep or "│"
vim.g.fold_line_char_open_start = "╭"       -- default: "┌"
vim.g.fold_line_char_open_end = "╰"         -- default: "└"
vim.g.fold_line_char_open_start_close = "╒" -- default: "╒"
vim.g.fold_line_char_open_end_close = "╘"   -- default: "╘"

Current fold only

To show lines for the current fold only, set vim.g.fold_line_current_fold_only to true.

Bar position strategy

The “bar” is the rendered character (for example │, ┌, └) drawn via virtual text.

You can control how its screen column is computed via fold_line_bar_pos_strategy:

• buffer-local: vim.b.fold_line_bar_pos_strategy
• window-local: vim.w.fold_line_bar_pos_strategy
• global: vim.g.fold_line_bar_pos_strategy

Priority: b: > w: > g: > default.

• vim.g.fold_line_bar_pos_strategy = "indent": align bars to (fold start) indentation (legacy behavior).
• vim.g.fold_line_bar_pos_strategy = "level": align bars by fold level (fixed step per level, like a foldcolumn).
• vim.g.fold_line_bar_pos_strategy = "hybrid": prefer "indent", but auto-degrade to "level" when foldmethod is expr/syntax (where indentation is often not meaningful).

If unset, it defaults to "hybrid".

Disabling

Set vim.g.fold_line_disable (globally) or vim.w.fold_line_disable (for a window) or vim.b.fold_line_disable (for a buffer) to true.