Skip to content

ooker777/breadcrumbs

 
 

Repository files navigation

Breadcrumb Trail

This plugin adds multiple new views to Obsidian.

The wiki has way more in-depth info on the plugin than this current outdated and limited readme file.

You can find the changelog here.

Basics

Breadcrumbs plugin lets you add hierarchical metadata to your notes and then leverage that structure.

Use

  • up/parent (↑)
  • unordered same/sibling (↔)
  • directional/orderly sibling (previous (←)/next (→))
  • down/child (↓)

relationships in your notes. You can name those relationship types anyway you want that best fits your purpose (up/parent/top/high/ancestor/founder/source/foo).

To get this structure, the plugin requires that you use some type of metadata indicating the hierarchy of notes:

  1. Frontmatter field. This is a field in the yaml format at the very top of your note. For example the me.md file could have the following frontmatter:
---
parent: [[dad]]
parent: [[mom]]
sibling: [[sister Lara]]
child: [[child Andre]]
---
  1. Inline (must use the Dataview plugin), among the normal text like this:
Punching is a very effective MMA technique (sibling:: [ [[Kicking]], [[Elbowing]], [[Kneeing]] ], parent:: [[Striking]])

(notice the double colon for the Dataview inline metadata).

  1. You can combine both approaches as well. For example your Course. 101 - Basics of Financing.md file might have the following content:
---
up: [[Year 2022 courses]]
same: [[Course. 103 - Basics of Programming]]
---
# Course. 101 - Basics of Financing
This course teaches the basics of financing. It contains several sub-areas:
- down:: [[101 - Basics of Financing. Lectures]]
- down:: [[101 - Basics of Financing. Group work]]
- down:: [[101 - Basics of Financing. Essay]]

Next:: [[Course. 201 - Advanced Financing]]

Matrix/List view

This view shows the current note's parents, siblings, and children in either of the following styles:

image

image

To open the view in your sidebar, run the command Breadcrumbs: Open View from the Command Palette (Ctrl+P).

Breadcrumbs Trail view

This view shows a trail of notes from the top of your vault down to your current note:

image

Using this structure that you impose, you can use the breadcrumb trail to visualise the path back to your parent note.

Juggl view

The Juggl plugin is tightly integrated with Breadcrumbs, such as with the Juggl view that can automatically be added above your current note:

Videos

Latest tutorial as of 2022-01-02

image|100

Video going in-depth into Threading feature, by @blizzingout

http://youtube.com/watch?v=AS5Mv6YNmsQ

First video about Breadcrumbs

image

Feed my coffee problem

If you're so inclined, you can buy me a coffee over here: https://ko-fi.com/skepticmystic :)

About

Visualise a custom hierarchy in your Obsidian vault

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 85.2%
  • TypeScript 12.5%
  • Svelte 2.2%
  • CSS 0.1%