Question: Differences from markdown-oxide?

[ficcdaf]

I recently learned about markdown-oxide, which is a similar tool (PKM LSP written in Rust). I'm curious, are you aware of this tool? And what sets IWE apart from it? Is there something IWE does differently, or are they both filling the same niche?

[gimalay]

There’s significant overlap between these two projects, but IWE has lots of unique features such as:

• notes hierarchy support with context aware search, and inlay hints for parent notes
• extract/embed notes graph transformations (via code actions)
• notes auto format which fixes link titles, header levels, list item numbers, etc. (usually on save)

IWE follows Zettelkasten concept where you have a flat list of files (no directories) where file name servers more like ID than a name of a document. While (as I understand) markdown-oxide follows Obsidian way with wiki-links.

IWE also includes CLI utility for batch operations and documents generation.

Another key difference is the core library, which is shared between the CLI and LSP. The rich domain model allows for the easy construction of new graph transformations.

[GitMurf]

So is there any option to have regular file names? Or do they have to be the auto generated IDs?

Also do you have to have Heading 1 in every document be the title of the document? Like the following (where "This is Foo" is the title of the file):

# This is Foo

## Overview

Some stuff about foo.

[ficcdaf]

OK that's awesome. Thanks for the features.

[gimalay]

@GitMurf you don't have to have header in every file. But symbols search works with the headers.

File names are completely up to you. IWE generates random file name when note is extracted but you can rename it to what ever you want.

LSP rename refactoring will update all the usages correctly.

[GitMurf]

@gimalay it would be amazing if at some point you could record a demo of how you use it daily. I've been playing around but having a hard time fully grasping the workflow. No hurry but when you do I'll be very interested to watch and learn!!

[gimalay]

There is a journal example here https://github.com/iwe-org/iwe/wiki/Journal-example

and a few short demo videos on the website.

IWE has no workflow. It’s just a tool for notes graph management. The workflow is totally up to you.

I usually start writing about some topic and as the note gets bigger extract parts of it and restructure hierarchy as needed.