Obsidian

Obsidian is the tool I use to maintain this knowledge base. I also use it extensively for my notes at work since joining Microsoft since:

1. It does not try to upload all my notes (and the secrets therein) to some third-party cloud service. I keep my Obsidian vaults in my corporate OneDrive or Sharepoints, allowing me to comply with corporate data management policy.
2. It supports linking between documents and finding information that I’ve forgotten very easy. This seems to work best for the way I take and re-read notes.

I’ve left Obsidian a few times, but I keep coming back. I now pay for a commercial license since I use it primarily for work. Obsidian keeps getting better too, and its direction of development lines up with what I need out of it.

Organization

I periodically try new ways of organizing, but I’ve found that just throwing everything into one unorganized pile (as is on display with this site) seems to work best. It lets me focus on just capturing details without the cognitive burden of fitting those details into some rigid folder structure at the same time.

Reference

I never remember how some of the markdown extensions in Obsidian work.

Callouts

See Callouts - Obsidian Help for the full assortment of callouts supported. Quartz supports these too.

Note

This is a note.

Abstract

This is an abstract. Aliases are summary and tldr.

Info

This is an infobox.

Warning

Stuff for which the reader should be mindful, like gotchas.

Danger

Worse than a warning I guess.

Question

Maybe for internal monologue?

Tip

This is a tip. Possibly a protip.

Example

Good for tutorials?

Success

Not sure how this is meant to be used.

Failure

Also not sure how this is meant to be used.

Todo

This is a todo.

Bug

Lorem ipsum dolor sit amet

Quote

This is neat. Better than the standard markdown >?

Mermaid graphs

See Examples | Mermaid.

Mermaid seems to be OK at making basic network diagrams, but they get messy fast. I don’t know if it is as expressive as graphviz.

---
title: Network topology
---
graph TD
	subgraph spines
		t00
	    t01
	end
	subgraph leaves
		t10
		t11
		t12
		t13
	end
	t00 --- t10
	t00 --- t11
	t00 --- t12
	t00 --- t13
	t01 --- t10
	t01 --- t11
	t01 --- t12
	t01 --- t13

---
title: Left-to-right
---
graph LR
    A[Square label] -- Edge label --> B((Circle label))
    A --> C(Rounded label)
    B --> D{Diamond}
    C --> D