https://github.com/ivan-lednev/better-search-views

Outliner-like breadcrumb trees for search, backlinks and embedded queries
https://github.com/ivan-lednev/better-search-views

obsidian-md obsidian-plugin outliner

Last synced: about 1 month ago
JSON representation

Outliner-like breadcrumb trees for search, backlinks and embedded queries

• Host: GitHub
• URL: https://github.com/ivan-lednev/better-search-views
• Owner: ivan-lednev
• License: mit
• Created: 2023-07-15T08:17:32.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-12-23T14:14:09.000Z (about 1 year ago)
• Last Synced: 2024-08-10T19:16:54.598Z (5 months ago)
• Topics: obsidian-md, obsidian-plugin, outliner
• Language: TypeScript
• Homepage:
• Size: 767 KB
• Stars: 224
• Watchers: 3
• Forks: 7
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

• jimsghstars - ivan-lednev/better-search-views - Outliner-like breadcrumb trees for search, backlinks and embedded queries (TypeScript)

README

        
# Better Search Views

> **Warning**

>

> - You need to reload Obsidian after you **install/update/enable/disable** the plugin

> - The plugin reaches into Obsidian's internals, so it may break after an update. If you noticed that, [please create an issue](https://github.com/ivan-lednev/better-search-views/issues)

## How to use it

Just install it and reload Obsidian. Now Obsidian's built-in global search, backlinks and queries should be decorated with breadcrumbs.

## What it does

### Before 'Better Search Views', search results look like this:

![image](https://github.com/ivan-lednev/better-search-views/assets/41428836/4069c2ef-6ec9-4a87-9881-2d300cddd10e)

### After 'Better Search Views' they look like this:

![image](https://github.com/ivan-lednev/better-search-views/assets/41428836/b191f14a-b75c-46d9-a19c-a8f91cafcd9f)

### A closer look

Let's open one of the files with matches, and see how the hierarchy in the search result matches the file:

![image](https://github.com/ivan-lednev/better-search-views/assets/41428836/953b2de2-cc9a-496c-ad85-27f0c361424a)

### But what does it do exactly?

The plugin brings more outliner goodness into Obsidian: it improves search views to create an outliner-like context around every match.

- **It patches native search, backlinks view, embedded backlinks and embedded queries**

- It renders markdown in the match to HTML

- It builds structural breadcrumbs to the match by chaining all the ancestor headings and list items above

- If the match is in a list item, it displays all the sub-list items below it

- If the match is in a heading, it displays the first section below the heading (you know, for context)

### Backlinks in document look like this

![image](https://github.com/ivan-lednev/better-search-views/assets/41428836/2f5229bc-8d3d-4027-b01c-fa36d5872716)

### Embedded queries look like this

![image](https://github.com/ivan-lednev/better-search-views/assets/41428836/bdf7fb5d-dcc2-4067-9abb-9c2064c09a27)

### Clicking on breadcrumbs works just as you might expect

![image](click-demo.gif)

### Hovering over any element with the control key pressed triggers a pop-up

![image](hover-demo.gif)

## Contribution

If you noticed a bug or have an improvement idea, [please create an issue](https://github.com/ivan-lednev/better-search-views/issues).

Pull-requests are welcome! If you want to contribute but don't know where to start, you can create an issue or write me an email: .

You can also support the development directly:



# Acknowledgements

- Thanks to [TFTHacker](https://tfthacker.com/) for [his plugin](https://github.com/TfTHacker/obsidian42-strange-new-worlds), which helped me figure out how to implement a bunch of small improvements

- Thanks to [NothingIsLost](https://github.com/nothingislost) for his awesome plugins, that helped me figure out how to patch Obsidian internals

- Thanks to [PJEby](https://github.com/pjeby) for his [patching library](https://github.com/pjeby/monkey-around)