Text Finder

by hafuhafu
5
4
3
2
1
Score: 58/100

Description

Category: Note Enhancements

The Obsidian Text Finder plugin is a handy tool for those who want to enhance their search-and-replace capabilities within Obsidian. It brings a feature-rich search and replace window, similar to what users are accustomed to in VSCode, but directly within the Obsidian editor mode. Users can search and replace text in their current Markdown file, with options for case sensitivity and regular expressions, adding flexibility for complex search needs. Additionally, the plugin highlights all matches and shows a count, making it easy to review search results at a glance. Customizable CSS options also allow for personalization, from styling match highlights to adjusting the search window's position. This plugin is ideal for users seeking a powerful, customizable text-finding experience within Obsidian.

Reviews

No reviews yet.

Stats

52
stars
13,540
downloads
2
forks
733
days
22
days
22
days
2
total PRs
0
open PRs
1
closed PRs
1
merged PRs
15
total issues
4
open issues
11
closed issues
86
commits

Latest Version

22 days ago

Changelog

Highlights

• Search and replace in selections — restrict searches to selected text in editing or reading mode; editing mode supports multiple selections and replacements. • Whole-word matching — combine with regex and case sensitivity. • Find/replace presets — save queries, match options and replacement values as named presets. Applying a preset never modifies note text automatically. • Upgraded search history — details, reuse, copy, batch delete and an 8-second undo, plus sorting and retention options. • Toolbar and appearance — reorder or hide actions, customize match/current-match/focus/selection colors, with live preview and a color picker. • Floating entry and movable finder — optionally show a compact search icon when opening notes; drag, dock or restore the finder. Improved mobile gestures and narrow layouts. • Reading mode improvements — full rendered-text indexing, cross-node and off-screen matches, hard-line-break markers, and selection search. Falls back to native find when unsupported. • More entry points — note “More options”, editor and reading context menus for “Find with selection” and “Find in selection”. • Performance and stability — matching and replacement candidates run in a Worker with cancellation and synchronous fallback; replacements respect the current read-only state.

Compatibility

• Requires Obsidian 1.6.0 or later. • Reading mode uses the plugin finder by default. The old native-search setting was removed; unsupported environments fall back automatically. • Existing settings and history are retained; the legacy reading native-search option is cleaned up. • Selection scopes do not convert between editing and reading mode; switching modes exits the scope but keeps the query and match options. • Reading mode is find-only. Embedded notes, formulas, Mermaid diagrams, Dataview output and similar third-party content are excluded from full-text search.


主要更新

• 选区查找与替换:编辑和阅读模式都可限定在选中内容中查找;编辑模式支持多个选区和选区内替换,阅读模式支持渲染正文选区和可选轮廓提示。 • 全字匹配:新增全字匹配选项,可与正则、大小写组合使用。 • 查找/替换预设:将常用查询、匹配选项和替换值保存为命名预设,支持编辑、排序、另存、删除和撤销;应用预设不会自动修改正文。 • 搜索历史升级:历史弹窗支持查看详情、复用、复制、批量删除,并新增排序与容量保留策略。 • 外观与工具栏:可调整查找/替换按钮的顺序和显示位置(常驻/更多/隐藏),自定义匹配、当前项、聚焦边框和选区颜色,并提供实时预览和颜色选择器。 • 悬浮入口与可移动查找框:打开笔记时可显示收起的小图标;查找框支持拖动、贴边收起和恢复位置,移动端增加手势与窄屏布局。 • 阅读模式增强:完整渲染正文索引、跨节点匹配、离屏内容、硬换行标记和阅读选区查找;不支持的环境会回退到 Obsidian 原生查找。 • 菜单入口:笔记右上角“更多选项”、编辑和阅读右键菜单支持“以选中内容查找”和“在选区中查找”。 • 性能与稳定性:匹配和替换候选优先在 Worker 中执行,支持取消和同步降级;替换提交会遵守当前只读状态。

兼容性

• 最低 Obsidian 版本提升到 1.6.0。 • 阅读模式默认使用插件查找;旧的“使用 Obsidian 原生查找”设置已移除,不支持时自动回退。 • 原有设置与历史数据继续沿用;旧的阅读原生查找选项会被清理。 • 编辑与阅读的选区范围不自动互转;切换模式会退出选区查找,但保留查询和匹配选项。 • 阅读模式不替换文件;嵌入笔记、公式、Mermaid、Dataview 等第三方内容不在全文查找范围内。

README file from

Github

Obsidian Text Finder

English | 中文说明

A VS Code-like finder for the current note in Obsidian: find and replace Markdown source in editing mode, or search rendered text in reading mode.

Features

  • Find and replace — highlight matches, see the match count, jump between results, and replace one or all matches in editing mode.
  • Flexible matching — regular expressions, case sensitivity and whole-word matching.
  • Search a selection — search selected text in editing or reading mode; editing mode also supports multiple selections and replacements within them.
  • History and presets — reuse previous queries and save named find/replace rules. Applying a preset never replaces note text automatically.
  • Independent split views — each note view keeps its own finder and current match, even when showing the same file.
  • Customizable toolbar and appearance — arrange or hide actions, adjust highlight colors and selection styling, move the finder, and optionally show a floating search entry.

Demo

Text Finder demo

Early-version demo; the current interface includes additional features.

Installation

Requires Obsidian 1.6.0 or later.

Method 1: Install from Obsidian's community plugins directory

In Settings → Community plugins, search for Text Finder, install it, and enable it.

Method 2: Install using the Better Manager plugin

Install and enable Better Manager, open its plugin manager, and use the GitHub installation option. Enter https://github.com/nyable/obsidian-text-finder, complete the installation, and enable Text Finder.

Method 3: Install using the BRAT plugin

Install and enable BRAT, run its Add a beta plugin for testing command, and enter https://github.com/nyable/obsidian-text-finder. Complete the installation and enable Text Finder.

Method 4: Install manually

Download main.js, styles.css and manifest.json from the latest release. Copy them into <vault>/.obsidian/plugins/text-finder/ and enable the plugin. If your vault uses a custom configuration folder, use that instead of .obsidian.

Quick start

  1. Open a Markdown note and run Text Finder: Open search in current file from the command palette. You can also use More options → Text Finder: Open find in the note's top-right menu.
  2. Enter a query. Use the previous/next buttons or Enter to navigate; toggle regex, match case or whole word as needed.
  3. To replace text, switch to editing mode and run Open search & replace in current file. To limit the search, select note text and run Open find in selection, then enter your query.
  4. Press Escape or click the close button to close the finder. Inputs and match options are retained by default.

Assign shortcuts in Settings → Hotkeys. Use Show search history to reuse queries, Save current find as preset to save a rule, and Apply find / replace preset to load one.

Settings and appearance

  • General: optionally show a floating search entry when opening notes, or collapse the finder when dragged to an edge. Both are off by default.
  • Find, Replace and Search history: adjust search behavior, replacement escapes and history preferences.
  • Appearance: preview colors and selection styling, reorder toolbar actions, choose Toolbar / More / Hidden, and set default match options.

Drag the left accent strip on desktop or the top-center grip on mobile to move the finder. Use Restore finder position if needed. For CSS customization, see the style reference and Style Settings example.

Notes and limitations

  • Searches the current note, not the whole vault. Reading mode is find-only; it does not modify files or switch to editing mode.
  • Editing searches Markdown source; reading searches rendered body text, so results may differ. Embedded notes, formulas, diagrams and some plugin-generated content are excluded.
  • Unsupported reading environments fall back to Obsidian's native find. Selection-restricted search never silently falls back to a full-note search.
  • Settings sync conflicts pause saving to protect disk data. Preserve unsaved local presets or settings before reloading the plugin.

For detailed matching and replacement rules, see features and limitations. Source builds and maintenance information are in the developer documentation.

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Core Search Assistant
5 years ago by qawatake
An Obsidian plugin to enhance built-in search: keyboard interface, card preview, bigger preview
Power Search
5 years ago by Aviral Batra
Settings Search
5 years ago by Jeremy Valentine
Adds a search bar to Obsidian.md's settings
Search Everywhere
5 years ago by Mom0
Obsidian Search Everywhere Plugin
Text Generator
5 years ago by Noureddine Haouari
Text Generator is a versatile plugin for Obsidian that allows you to generate text content using various AI providers, including OpenAI, Anthropic, Google and local models.
Card View Switcher
5 years ago by qawatake
An Obsidian plugin to provide a quick switcher with card view
Version History Diff (Sync, File Recovery & Git)
5 years ago by kometenstaub
Get a diff view of your Obsidian Sync, File Recovery and Git version history
Quiet Outline
5 years ago by the_tree
Improving experience of outline in Obsidian
Book Search
5 years ago by anpigon
Obsidian plugin that automatically creates notes by searching for books
Translator
4 years ago by Haifeng Lu
A plugin for Obsidian to translate selected text.
Copy Search URL
4 years ago by Carlo Zottmann
A plugin for Obsidian (https://obsidian.md) that adds a menu entry to its search view for copying the Obsidian search URL.
Text Dataset Aid Plugin
4 years ago by Conner Ohnesorge
This is a obsidian plugin to help with the creation of personal jsonl datasets for text generation models.
Toggle Case
4 years ago by automattech
Obsidian plugin to toggle between `lowercase` `UPPERCASE` and `Title Case`
External Link Helper
4 years ago by Jhonghee Park
Obsidian plugin for link suggestion
Text Extractor
4 years ago by Simon Cambier
A (companion) plugin to facilitate the extraction of text from images (OCR) and PDFs.
Contacts
4 years ago by vbeskrovnov
With this plugin, you can easily organize and manage your contacts within Obsidian. Simply create a note with contact information and use the plugin's features to quickly search, and sort through your contacts. Contacts plugin also helps you to remember birthdays of your contacts and keeps track of the last time you met them.
Khoj
4 years ago by Debanjum Singh Solanky
Your AI second brain. Self-hostable. Get answers from the web or your docs. Build custom agents, schedule automations, do deep research. Turn any online or local LLM into your personal, autonomous AI (gpt, claude, gemini, llama, qwen, mistral). Get started - free.
Unicode Search
4 years ago by BambusControl
Simple Unicode character search for Obsidian.md
Emoji Magic
4 years ago by simplgy
Makes it easier to add emojis using an improved keyword search
Global Search and Replace
4 years ago by Mahmoud Fawzy Khalil
A plugin to do a global search and replace in all your Obsidian vault files.
Jelly Snippets
4 years ago by Spencer Gouw
A simple text snippets plugin for Obsidian.md. BACKUP SNIPPETS BEFORE UPDATING.
Floating Search
4 years ago by Boninall
A plugin for searching text by using Obsidian default search view.
Semantic Search
4 years ago by bbawj
Semantic search for Obsidian.md
Colored Text
4 years ago by Erinc Ayaz
Fuzzy Chinese Pinyin
4 years ago by lazyloong
Colored Tags
3 years ago by Pavel Frankov
Colorizes tags in different colors.
Simple CanvaSearch
3 years ago by ddalexb
Search Templates Library
3 years ago by Pentchaff
Obsidian plugin that allows to store searches templates for later use, and displays search results both in the search view and graph view.
Text Transform
3 years ago by ipshing
Text Conversions
3 years ago by Juan D Frias
Text conversions for Obsidian
Dynamic Text Concealer
3 years ago by Matt Cole Anderson
Obsidian.md Plugin to conceal or replace user configured text patterns in Live Preview and Read Mode.
Text Focus
3 years ago by usysrc
Focus the text area when opening a new note.
Moulinette Search for TTRPG
3 years ago by Moulinette
Plugin for Obsidian
Regex Mark
2 years ago by Mara-Li
Search In Canvas
2 years ago by Boninall
Remove Newlines
2 years ago by Elias Jaffe
A plugin for Obsidian.md which removes newlines and blank lines from selected or pasted text.
Giphy
2 years ago by LuCrypto
Arcane Obfuscate
2 years ago by Shusako
Obfuscate text in Obsidian.md with an arcane runic effect.
Blockreffer
2 years ago by tyler.earth
An Obsidian plugin to search and embed blocks with ^block-references (aka ^block-ids)
Text expand
6 years ago by MrJackphil
A simple text expand plugin for Obsidian.md
Vantage - Advanced search builder
6 years ago by ryanjamurphy
Vantage helps you build complex queries using Obsidian's native search tools.
Tag Wrangler
6 years ago by PJ Eby
Rename, merge, toggle, and search tags from the Obsidian tag pane
Text Snippets
6 years ago by Ariana Khitrova
Snippets plugin for obsidian
Find and replace in selection
6 years ago by Dmitry Savosh
Obsidian plugin. Find and replace in selection.
Text Format
5 years ago by Benature
Format seleted text in Obsdidian.md
Relative Find
5 years ago by phibr0
Text Transporter
5 years ago by TfTHacker
Text Transporter - advanced text management for Obsidian.
Another Quick Switcher
5 years ago by tadashi-aikawa
This is an Obsidian plugin which is another choice of Quick switcher.
Omnisearch
5 years ago by Simon Cambier
A search engine that "just works" for Obsidian.
Colorizelt
2 years ago by Artsem Holub (WiNE-iNEFF)
Easy color and clear selected text
Lemons Search
2 years ago by Moritz Jung
An Obsidian plugin that offers a fast fuzzy finder based quick switcher with preview.
Tree Search
2 years ago by catacgc
Textgrams
2 years ago by Akop Kesheshyan
Create and store ASCII graphics in your Obsidian
Snippetsaurus
2 years ago by Christian Humbert
Clipper Catalog
2 years ago by Greg K.
A catalog view that provides a powerful interface for all your clipped web articles and content. Easily organize, search, and manage your web clippings within your vault.
NetClip
2 years ago by Elhary
this plugin is for Obsidian that allows you to browse the web and clip webpages directly into your vault.
Media Companion
2 years ago by Nick de Bruin
Image Picker
2 years ago by ari.the.elk
TG Emoji Search
2 years ago by MarsBatya
CmdSearch
2 years ago by SpaceshipCaptain
EasyLink
a year ago by isitwho
Select text in your obsidian editor to find the most similar content from other notes and easily create links.
Clipboard Manager
a year ago by Ayush Raj
The clipboard obsidian plugin
Note Codes
a year ago by Ezhik
Reference your Obsidian notes from anywhere with simple 4-character codes.
Segerlab
7 months ago by Semyon Kononchuk
Renders calculator views within Obsidian notes from JSON data copied from the Segerlab app.
Local REST API with MCP
6 months ago by Adam Coddington
A secure REST API and Model Context Protocol (MCP) server for your vault.
Mention Autocomplete
4 months ago by Darren Zheng
Type `@` to instantly search and link any note in your vault — with full-text search, rendered preview, and smart sentence extraction.
Notebook Navigator
4 months ago by Johan Sanneblad
A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.
Journal View
3 months ago by RUverse
A journal view for Obsidian
Oriko
2 months ago by trevware
A pannable, zoomable wall of your web clippings. Sort them into grids, filter by any property, and clip from your phone. Media is downloaded into your vault, so clippings keep their images and videos even if the source page is deleted.
Sift
2 months ago by disasta-g
Search your notes with substring matching, operators, path and date filters, and ranked results in a large overlay.
Vault Shelf
2 months ago by Lukas Proprentner
Your Obsidian vault as a browsable library: shelves of books built from titles, dates, people, tags, folders or any note property. Customizable to make it your own.
Settings Navigator
2 months ago by Lawrence Lee
An Obsidian plugin that adds browser-style history navigation, quick plugin management, and quality-of-life improvements to the Settings modal.
MCP Server
a month ago by leonezz
Grid Note
25 days ago by dcx199302
将Markdown文档转换成结构化的卡片布局,让卡片和结构更加清晰
QMD Search
20 days ago by xia-ataraxia
Obsidian plugin for local QMD search, related notes, and autosync.