Tech Collectives
Interactive Workshop · 30 minutes

Markdown & Obsidian

Your first knowledge system, built in 30 minutes. If you can write a text message, you can write Markdown. Work through the nine lessons below and you'll finish with a real, working system on your own computer.

9 mini lessons 4 hands-on practice checks 1 live Markdown playground $0 cost, forever
Your progress
0 / 9
Lesson 002 minutes

Why we standardize on Obsidian

We picked one tool on purpose, so we can teach it well, help each other, and build shared habits.

It's free

No subscription, no paywall. Start today, keep it forever.

It writes plain Markdown

Your notes are ordinary .md files. They open in any text editor, on any computer, for the rest of your life.

It works with Claude CoWork

Point CoWork at your folder and Claude can read, write, and help organize your notes directly.

It links ideas naturally

Notes connect to other notes. You stop collecting files and start building a web of thinking.

The point: not just a text editor, but a practical knowledge system from day one. What you learn here doesn't expire.
Quick check

What actually lives inside an Obsidian vault?

Lesson 015 minutesHands on

What is Markdown?

Markdown is a way to add formatting to plain text using ordinary characters. Instead of clicking a bold button, you type symbols. The file stays readable either way.

The whole language, more or less

This is genuinely most of what you'll ever need:

# Big Heading
## Smaller Heading
### Smaller Still

**bold text**
*italic text*

- a bullet point
- another bullet point

1. a numbered list
2. the next item

[a link](https://obsidian.md)

> a quote or callout

`a snippet of code`

Try it live

Type in the left box. The right side shows what it becomes. Nothing you do here touches your computer, so experiment freely.

You typeYou get
Practice

Write a small note that uses four things at once: a level-2 heading, one bold phrase, one italic phrase, and a bullet list with at least two items.

  • A line starting with ## and some text
  • Something wrapped in **double asterisks**
  • Something wrapped in *single asterisks*
  • Two or more lines starting with -

Worth knowing: Markdown is everywhere. GitHub, Reddit, Discord, Notion, and CoWork all speak it. Learn it once, use it everywhere.
Quick check

Which one makes text bold?

You open a .md file in Notepad. What do you see?

Lesson 025 minutesOn your computer

Install Obsidian

Four steps. Do them now, in a second window, and come back.

  1. Go to obsidian.md in your browser.
  2. Click Download and choose your system: Windows, Mac, or Linux.
  3. Open the downloaded file and follow the install prompts.
  4. Launch Obsidian.

The first time it opens, Obsidian asks you to create or open a Vault. A vault is a folder on your computer where your notes live. That's all it is. Don't overthink it. We'll create ours in the next lesson.

If you get stuck: a security warning on first launch is normal for any app you download directly. Choose to open it anyway. Obsidian is used by millions of people and asks for no account.

Check them off as you go

  • Downloaded the installer for my system
  • Installed it
  • Obsidian opens and I can see the welcome screen
Lesson 033 minutesOn your computer

Create your AI Workspace

One folder. Everything you build from here lives inside it.

  1. On Obsidian's welcome screen, click Create new vault.
  2. Name it My AI Workspace.
  3. Choose where to save it. Documents is a fine home. Click Create.

You now have an empty vault. This folder is yours. Everything you put in it is a normal file you can find in Finder or File Explorer, back up, email, or open on another machine.

Name it exactly My AI Workspace. Lesson 08 connects this same folder to Claude CoWork, and matching names keeps the instructions simple.
  • Created a vault named My AI Workspace
  • I know where on my computer it lives
Quick check

You want to back up your vault. What do you do?

Lesson 0410 minutesHands on

Create your first notes

Six starter notes. Together they give you a simple system: where you're headed, who you are, what your assistant does, what you're building, what you're dreaming up, and what happened today.

How to create a note

  • Click the New note icon (a small page with a pencil) in the top left, or press Ctrl/Cmd + N.
  • Type a title at the top, press Enter, and start writing.
  • Obsidian saves automatically. There's no Save button to remember. It's already done.

The six notes

Copy each template into a new note. The copy button puts it on your clipboard, ready to paste.

Goals.mdWhat you're working toward
# My Goals

## This Quarter
-

## This Year
-

## Someday
-
About-me.mdWho you are and who you serve
# Who I am / what I do

## Who I serve
-

## My #1 constraint right now
-
Assistant.mdHow your AI assistant should work
# My Assistant

## Role, who it is (the expert in your corner)
-

## Tasks, what it does again and again
-

## Outputs, what it delivers and in what format
-
Projects.mdWhat you're actively building
# Projects

## In Progress
-

## Next Up
-

## Done
-
Ideas.mdCatch sparks before they fade
# Ideas

-
Daily Notes.mdWhat happened, what you learned, what's next
# Daily Notes

## 2026-08-25
- What I worked on:
- What I learned:
- Tomorrow:
Practice

Build your own note structure from scratch. Write a title as an H1, then two sections as H2 headings, with at least one bullet under them.

  • One line starting with a single #
  • Two or more lines starting with ##
  • At least one bullet with something written on it

Start messy. Don't fill these in perfectly. A note you actually use beats a perfect one you never open.
Lesson 053 minutesHands on

Edit a note

Editing is just typing. Open a note, click where you want to change something, and write.

  • Type **something** and watch it turn bold.
  • Start a line with - to make a bullet.
  • Start a line with # to make a heading.

Obsidian has two views: Edit, where you type raw Markdown, and Reading, a clean formatted view. Toggle with the book or pencil icon in the top right, or press Ctrl/Cmd + E. Seeing both is what makes the formatting click.

Edit view

You see **bold** with the asterisks. This is where you work.

Reading view

You see bold, clean. This is where you share your screen or read back.

Practice

Write a three-line status update that includes a quote line, an inline code snippet, and a link.

  • A line starting with >
  • Something wrapped in `backticks`
  • A link in the form [label](url)

Quick check

You typed a heading but it still shows the # symbol. What happened?

Where's the Save button?

Lesson 065 minutesThe part that matters

Link your notes

This is what makes Obsidian more than a text editor. Type two square brackets and start typing a note name.

See my [[Goals]] for the big picture, and [[Projects]] for what I'm building now.

As you type, Obsidian suggests existing notes. Pick one and a live link is created. Click that link anytime to jump straight there. If the note doesn't exist yet, clicking the link creates it.

You're not filing notes into folders you'll forget. You're building a connected web of your own thinking. Open the Graph View (the icon that looks like connected dots) to see it.

Daily Notes Goals Projects Ideas About-me

Six notes, no links yet. Write two wikilinks below to connect them.

Practice

Write one sentence that links to two of your notes using double square brackets.

  • Two or more [[wikilinks]] with names inside
  • A real sentence around them, six words or more

The habit worth building: every time you mention something you've written about before, link it. Ten links in, the vault starts answering questions you forgot you asked.
Quick check

You write [[Runway]] but no note called Runway exists yet. What happens?

Lesson 071 minute

Delete a note

Cleaning up is as easy as creating.

  • Right-click the note in the left-hand file list and choose Delete, or
  • Open the note, press Ctrl/Cmd + P for the command palette, type "delete," and pick Delete current file.

Deleted notes go to your vault's trash or your system trash, depending on your settings, so a slip-up is recoverable. To change where they go, visit Settings → Files & Links → Deleted files.

Learn the command palette now. Ctrl/Cmd + P is the single most useful key combination in Obsidian. Every command lives there, searchable by name, so you never have to hunt through menus.
  • Created a throwaway note and deleted it
  • Opened the command palette with Ctrl/Cmd + P
Lesson 085 minutesWhere it gets powerful

Connect your folder to Claude CoWork

Once CoWork can see your My AI Workspace folder, Claude becomes a thinking partner inside your own notes.

  1. Open Claude CoWork.
  2. Choose the option to connect or select a folder.
  3. Navigate to your My AI Workspace vault and select it.

Three things to ask on day one

Turn goals into steps

"Read my Goals.md and suggest three concrete steps I can take this week."

Summarize your week

"Summarize my Daily Notes from this week into a short update I can send my team."

Grow an idea

"Turn the rough thoughts in Ideas.md into a one-page project plan."

Claude reads and writes the same .md files you do. You stay in control. It's your vault, your words, your system. CoWork just helps you move faster.

Why this works so well: your notes are plain text, so nothing has to be converted, uploaded, or opened with a special key. The same property that makes Markdown durable is what makes it easy for an AI assistant to work with.
  • Connected My AI Workspace to CoWork
  • Asked Claude one question about my own notes
Lesson 09You're done

Work through the nine lessons

In about half an hour you go from zero to a real knowledge system: create, edit, link, and delete Markdown notes, connected to an AI partner that helps you think and build.

0 / 9

Here's the one habit that makes it stick: open Daily Notes.md tomorrow and write three lines. Knowledge systems aren't built in a burst. They're built in small daily deposits. Start before you feel ready. You already have everything you need.

Quick reference

ActionHow
New noteCtrl/Cmd + N
Switch Edit / Reading viewCtrl/Cmd + E
Command paletteCtrl/Cmd + P
Link to another note[[Note Name]]
Bold / italic**bold** / *italic*
Heading# at the start of a line
Bullet list- at the start of a line
Quote or callout> at the start of a line
Delete a noteRight-click the file, then Delete
See your linked ideasOpen Graph View