Obsidian is a markdown‑based knowledge base that works offline. Designers can store sketches, style guides, and project briefs in a single vault. This guide shows you how to set up Obsidian, organize assets, and use visual plugins. Follow each step, copy the code snippets, and watch the screenshots for a smooth workflow.
Download the installer from obsidian.md. Choose the Windows, macOS, or Linux version. The installer is under 40 MB and runs without admin rights.
A vault is a folder on your computer. Click New vault, give it a name like DesignVault, and select a location on your SSD for fast access.
mkdir ~/Documents/DesignVault
obsidian --vault DesignVault
Obsidian will open the empty vault ready for notes.
Keep your files tidy with a clear hierarchy. Below is a recommended structure:
DesignVault/
├─ 00_Archive/
├─ 01_Projects/
│ ├─ Project‑Alpha/
│ │ ├─ brief.md
│ │ ├─ assets/
│ │ │ ├─ mockup.png
│ │ │ └─ styleguide.pdf
│ │ └─ canvas/
├─ 02_Resources/
│ ├─ typography.md
│ ├─ colors.md
│ └─ inspiration/
└─ 03_Templates/
└─ design‑brief-template.md
Drag an image into a note or use markdown syntax:

The double brackets make the link relative, so the note works on any device.
When you write [[Typography]] inside a project brief, Obsidian automatically creates a backlink in the Typography note. This creates a network of related ideas without extra effort.
Use tags like #ui, #branding, or #client‑X. The tag pane lets you see all notes with a specific tag, ideal for sprint reviews.
Canvas is Obsidian’s whiteboard‑style view. Each node can hold a note, an image, or a link. It’s perfect for mood boards, user‑flow diagrams, or sprint backlogs.
Project‑Alpha Canvas.Place three image nodes side by side, then draw arrows to indicate hierarchy.
| Plugin | Key Feature | Price |
|---|---|---|
| Obsidian Excalidraw | Hand‑drawed sketches directly in notes | Free |
| Obsidian Color Picker | Palette panel, HEX/RGB copy | Free |
| Kanban | Board view for task tracking | Free |
| Advanced Tables | Spreadsheet‑like editing inside markdown | Free |
| Obsidian Sync (optional) | Encrypted cloud sync across devices | $8/mo |
Go to Settings → Community plugins → Browse, search the name, click Install, then enable.
// Example: enabling Excalidraw
{
"plugins": {
"excalidraw": true
}
}
Create a sketch of a UI component, then embed it in a note:
![[Excalidraw/Component‑Sketch.excalidraw]]
Open the note, press Ctrl+Shift+E, choose “Export to PDF”. The PDF keeps headings, images, and internal links as clickable anchors.
Obsidian Publish (paid) lets you host a public site from your vault. For free sharing, sync the vault to a shared Dropbox folder and give teammates access.
Combine color, typography, and component notes into one document using the “Advanced Export” plugin.
# Style Guide
![[02_Resources/colors.md]]
![[02_Resources/typography.md]]
![[01_Projects/Project‑Alpha/assets/styleguide.pdf]]
| Feature | Obsidian | Notion | Milanote |
|---|---|---|---|
| Offline‑first | Yes | No (partial) | No |
| Markdown native | Yes | Limited | No |
| Canvas/Whiteboard | Built‑in Canvas | Limited board view | Strong visual board |
| File attachments | Unlimited local files | Up to 5 MB per file (free) | 5 MB limit |
| Pricing (core) | Free | Free with limits | Free tier limited |
| Collaboration | Sync (paid) or shared folder | Real‑time | Real‑time |
Yes, the core app is free. Premium services like Sync and Publish are optional.
You can embed live Figma frames with an <iframe> link or attach Sketch files as PDFs. Obsidian treats them as regular attachments.
The “Obsidian Color Picker” plugin adds a palette panel and lets you copy HEX or RGB values directly into notes.
Collaboration works through Obsidian Sync or a shared folder on Dropbox/OneDrive. Real‑time editing isn’t built‑in yet.
Use the built‑in “Export to PDF” command or the “Advanced Export” plugin to keep headings, images, and backlinks.
Obsidian gives designers a fast, offline‑first workspace. Use the folder structure, backlinks, Canvas, and plugins to keep ideas, assets, and tasks in one place. Export to PDF or sync the vault to share your work with clients and teammates.