• Stars
    star
    146
  • Rank 252,769 (Top 5 %)
  • Language
    TypeScript
  • Created almost 4 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Discover the story between your notes in Obsidian

Obsidian Journey Plugin - Discover the story between your notes!

GitHub release) GitHub all releases

Hey there and welcome!

Alexis here - Obsidian enthusiast and student at the University of Life!

I want to show you a new Obsidian plugin I've been working on.

This plugin automatically creates an outline for your publishing.

An outline for an article, a blog post, or even a book!

Why do we need this?

I’ve noticed that my creative output using Obsidian hasn't been as prolific as I’d like it to be.

I have hundreds of atomic notes in my vault, I’ve followed every best-practice, but right now, Obsidian didn’t help me take that next step.

It’s really hard to extract a good story from my vault.

This plugin automatically finds and creates the outline of my story like so:

What the plugin finds for you

Tutorial

Watch on Youtube: https://youtu.be/6k2Lp1pCZpY

Included Features

Based on the amazing community feedback and comments, I realized that there are many different ways to go on that journey and so I've created a bunch of features you can toggle on or of to your liking.

These features are like preferences you can give your navigation-system in your car. Maybe today, all you care about is getting from A to B quickly. Maybe tomorrow, you have more time to "take the scenic route." I want you to be as flexible as possible.

Path-Finding Features

➡️ Use "Forward-Links" (Enabled by default)

If set, allows to travel using forward-links. If you have a graph like this: A -> B -> C and you ask about the story between A and C, it will give you 'A, B, C' since A forward-links to B and B forward-links to C

⬅️ Use "Back-Links" (Enabled by default)

If set, allows to travel using back-links. If you have a graph like this: A -> B -> C and you ask about the story between C and A, it will give you 'C, B, A' since C has a back-link from B and B has a back-link from A

Include Tags Feature

🏷 Use tags (Disabled by default)

If set, allows to travel using tags.

Avoid Traveling via Certain Notes Features

🏞 "Take the scenic route" (Disabled by default)

If set, will skip 'hub' notes with too many links (MOCs). Configure exactly how many links make a MOC below.

⚙️ "How many links make a MOC?"

Configure at which point to skip a note because it contains too many out-bound links. Applies only if 'Take the scenic route' above is set.

🙅🏻‍♀️Exclude specific folders (Disabled by default)

If set, will note include notes from the specified folders in your search. Please use comma to deliminate several folders

Clipboard Settings Feature

🔗 Enable automatic linking (Disabled by default)

If set, will turn titles in the list into links to their respective note

🤪 Enable automatic transclusion (Disabled by default)

If set, will automatically create transcluding links for you ('![[note]]' instead of '- [[note]]')

Accessibility Feature

🔎 Enable High-Contrast

If set, will increase the contrast to make the result-list easier to read.

Join the Discussion!

Share your ideas and feedback on the plugin. We regularly vote on which features should be built next

https://forum.obsidian.md/t/new-plugin-journey-find-the-story-between-your-notes/12153

A huge shout-out to thoresson, alltagsverstand, Thecookiemomma, cestvrai, matteor, Danashafir, EhuddRomero, I-d-as, osgav, Erick_James_Dodge, 3mbry0, Klaas, ryanjamurphy, EdElgar and Daveb08 for helping making this awesome for everyone!

How to submit an issue

🐞 If you run into a TECHNICAL ISSUE or BUG: Please submit a Github Issues at https://github.com/akaalias/obsidian-journey-plugin/issues

See what features are coming up

https://trello.com/b/ICKWjoBu/obsidian-journey-plugin-backlog

Trello

Path-Finding Feature Deep Dive

Because each feature has an impact to whether the plugin CAN FIND or CANNOT FIND a path between your two notes, I want to demonstrate what each does as simply as possible.

So, let's start by imagining this very basic vault with 4 notes. "Note A", "Note B", "Note C" and "Note D"

  • A links to B
  • B links to C
  • C shares the same tag as D

Vault

Feature 1: Use "Forward-Links" (Enabled by default)

Links are basically one-way streets from one note to the next. That means the plugin will show you only a path IF a forward-linked path exists but it won't show you a path that goes "against" the one-way street.

forwardlink

With the example and this feature turned ON, the plugin will...

  • Successfully find you a path from A to C (Via B)
  • NOT find you a path from C to A because that would be against the one-way street

Feature 2: Use "Back-Links" (Enabled by default)

This is basically the inverse of using "forward-links". With this feature, you navigation system will find ONLY paths that are based on going against the one-way streets.

backlink

With the example and this feature turned ON, the plugin will...

  • NOT find a path from A to C because there are no back-links to follow
  • Successfully find you the path from C to A (Via B) because the back-links point that direction

Feature 3: Using Tags (Disabled by default)

Thank you alltagsverstand for the idea which I had not thought of and which resonated with many of you.

As the name suggests, Tags can now also be paths between notes.

tag

With the example and this feature turned ON, the plugin will...

  • Successfully find the path from C to D (C -> #tag -> D) and from D to C (D -> #tag -> C)

If I now have Back-Links and Forward-Links enabled as well, I can now find the path from:

  • A to D (A -> B -> C -> #tag -> D)
  • D to A (D -> #tag -> C -> B -> A)

Note that this feature is disabled by default.

Feature 4: "Take the scenic route" aka Avoid MOCs (Disabled by default)

One of thoresson's many ideas that turned out to be really, really useful when I started to pressure-test finding cool paths.

Avoid Y (perhaps a tag used for MOC and other structured notes so that only atomic notes are included in the journey)

If turned on, this feature will exclude finding a path via MOC notes and help you "take the scenic route" instead. With this feature, you avoid passing through the "big city" (aka MOC) and instead find a path less traveled.

In the following example, with this feature turned ON, the path from A to C would be:

  • A -> Foo -> Bar -> C (instead of A -> MOC -> C)

MOC

"How many links make an MOC?"

A sub-feature for "taking the scenic route" where you can define at what amount of links inside a note makes it an MOC to avoid.

The original launch demo

Watch on Youtube: https://youtu.be/iRydNlinRlc

More Repositories

1

obsidian-extract-pdf

Extract PDFs to Markdown within Obsidian
JavaScript
230
star
2

obsidian-extract-pdf-highlights

Extract highlights, underlines and annotations from your PDFs into Obsidian
TypeScript
220
star
3

obsidian-footnotes

Makes creating footnotes in Obsidian more fun!
TypeScript
136
star
4

extract-highlights-plugin

Manage your highlights in Obsidian by easily creating, removing and exporting them.
TypeScript
88
star
5

dangerzone-writing-plugin

A plugin that forces you to write for X seconds. If you pause for more than 5 seconds, everything you've written in this note is DELETED.
TypeScript
69
star
6

quickdown

QuickDown – A better inbox for your ideas
Swift
63
star
7

obsidian-shuffle

Create custom and randomized writing prompts
TypeScript
47
star
8

Streamline

Streamline is a stream-of-consciousness writer for Obsidian
Swift
25
star
9

getunblah

An app for those (like myself) who talk too much, or too little, when they get nervous in meetings
SCSS
22
star
10

algorand-ballet

A qualitative analysis tool for the Algorand blockchain
Vue
15
star
11

plotto-for-obsidian

Write your plots faster with this 'batteries-included' collection of Plotto plain text markdown files for Obsidian.md
HTML
14
star
12

text-expander-plugin

A bare-bones and opinionated proof-of-concept text expander utility for Obsidian
TypeScript
13
star
13

getstreamline

Streamline is a stream-of-consciousness writer for Obsidian
HTML
11
star
14

getquickdown

QuickDown – A better inbox for your ideas.
SCSS
8
star
15

obsidian-recursor

An ambient plugin that will place your cursor back to where you left off.
TypeScript
8
star
16

getjamgpt

A free, instant & bespoke ChatGPT app for macOS
HTML
6
star
17

menu-bar-breathing

A small MacOS menu bar app that helps you breathe
Swift
5
star
18

obsidian-airgap

This plugin allows you to link to notes in an airgapped vault. This is useful if you want to link to ideas from one vault while working in a different one without the danger of mixing up the two.
TypeScript
5
star
19

Poppy

Poppy keeps your single most important webpage on top of all other windows. Very useful while writing with ChatGPT or pair programming on a backlog ticket.
Swift
5
star
20

pudding

Follow the Money, Find the Story. Have more fun with OSINT analysis and reconnaissance in decentralized finance ecosystems.
TypeScript
3
star
21

extracthighlights-dist

Custom PDFJS library for highlights
JavaScript
2
star
22

the-little-clojurian

My TDD implementation of "The Little Schemer" in Clojure.
Clojure
2
star
23

blockchain-toy

A recursive toy algorithm to calculate the nonce for zero-padded SHA256 hashes
Clojure
2
star
24

getpogo

Unlock the Power of GPT3 and OpenAI with a Single Keyboard Shortcut
1
star
25

LangChainInABox

A native macOS app for playing with LangChain that ships with a self-contained, embedded, Apple-notarisable Python 3.11 and up-to-date LangChain libraries
Python
1
star
26

KeyPair

KeyPair makes using keyboard shortcuts during pair programming sessions easier.
Swift
1
star
27

obsidian-dashboard

Dashboard for Obsidian
TypeScript
1
star