Obsidian

Thu, 04 Jun 2026 00:00:00 +0000

Obsidian is a local-first Markdown note-taking and knowledge management tool. Notes are plain .md files in a folder on disk — your vault. No proprietary format, no cloud lock-in, no account required. Open the folder in any text editor and the files are right there.

The core feature is bidirectional linking: [[note name]] creates a link between notes, and Obsidian builds a graph of all connections. This makes it useful for capturing ideas that relate to each other — architecture decisions, research, running notes on a project — without forcing a rigid folder hierarchy upfront.

Plugins extend the core significantly. Community plugins cover daily notes, task management, canvas (spatial note layout), Dataview (query your vault like a database), Git sync, and more.

For a dev workflow, a common setup is a vault in a Git repository — plain Markdown means diffs are readable, history is useful, and syncing across machines is standard Git push/pull.

Resources

Markdown

Mon, 01 Jan 2024 00:00:00 +0000

Markdown is a lightweight markup language that converts to HTML. The syntax is designed to be readable as plain text — a # Heading looks like a heading even in a text editor, and **bold** reads naturally. John Gruber created the original spec in 2004; CommonMark later formalised an unambiguous specification. GitHub Flavored Markdown (GFM) extends CommonMark with tables, task lists, and syntax-highlighted fenced code blocks.

Core syntax

# Heading 1
## Heading 2

**bold** *italic* `inline code`

- unordered list item
- another item
 - nested item

1. ordered list
2. second item

[link text](https://example.com)
![alt text](image.png)

> blockquote

--- (horizontal rule)

Code blocks

Fenced code blocks with a language identifier get syntax highlighting in most renderers:

```go
func main() {
 fmt.Println("hello")
}
```

Tables (GFM)

| Column 1 | Column 2 |
|---|---|
| value | value |

Alignment is controlled by colons in the separator row: |:---| left, |---:| right, |:---:| centre.

Front matter

Static site generators (Hugo, Jekyll) extend Markdown with YAML front matter — a metadata block delimited by --- at the top of the file. Hugo uses it for titles, dates, tags, and draft status; it is not part of the Markdown spec but is the universal convention in docs-as-code workflows.

Markdown on Backend Engineering Strategy Tools

Obsidian

Resources

Markdown

Core syntax

Code blocks

Tables (GFM)

Front matter

Resources