mirror of
https://github.com/obsidian-nvim/obsidian.nvim.git
synced 2026-11-17 03:00:32 +00:00
Page:
File
Pages
Actions
Attachment
Audio recorder
Autocmds
Bookmarks
Breaking Changes
Cache
Checkbox
Commands
Completion
Daily Notes
Editing this wiki
Extensions
File
Folding
Footer
Frontmatter
Home
Images
Integrations
Keymaps
LSP Progress
LSP
Link
Navigation
Note
Open
Recipes
Resolvers
Scripting
Search
Startup Guide
Statusline
Sync
Tag
Template
Unique Note
Workspace
No results
1
File
github-actions edited this page 2026-06-25 14:50:33 +00:00
Table of contents
Ignore Filters
The file.ignore_filters option lets you ignore specific files or
directories from being processed by obsidian.nvim. This is useful when you have
markdown files in your vault that shouldn't be treated as Obsidian notes.
Important
Users should use simple gitignore-style globs without modifiers. Ripgrep (rg) compatibility is not guaranteed.
Pattern Syntax
The ignore filters use gitignore-style pattern matching:
archive- matches any file or directory named "archive"archive/- matches only directories named "archive"private/**- matches all files under "private" directory*.bak.md- matches any file ending with ".bak.md"/README.md- matches "README.md" only at vault root**/draft.md- matches "draft.md" at any depthdrafts/*.md- matches markdown files directly under "drafts" (not in subdirectories)
Important
All patterns must be relative to the workspace root.
Examples
{
file = {
ignore_filters = {
"archive", -- ignore the "archive" directory
"private/**", -- ignore everything under "private"
"*.bak.md", -- ignore backup files
"slides/present.md", -- ignore a specific file
},
},
}
Behaviour
Files in the ignore list will:
- not have the LSP attached
- not have keymaps registered
- not have frontmatter processed
- not appear in search results
- not be included when iterating over vault files
Options
---@class obsidian.config.FileOpts
---
--- A list of gitignore-style glob patterns to ignore files and directories.
--- Users should use simple gitignore style globs without modifiers,
--- and ripgrep compatibility is not guaranteed.
---@field ignore_filters? string[]
file = {
ignore_filters = {},
}
🌟 obsidian.nvim
Topics
- Actions
- Autocmds
- Commands
- Folding
- Extensions
- Images
- Integrations
- Keymaps
- Navigation
- Scripting
- Startup-Guide
- Recipes
- LSP
- LSP-Progress