## What Obsidian is
- A tool that helps you think by organizing and connecting information in whatever way you need.
- In community jargon, a knowledge management platform/personal knowledge graph tool
- [Free to download and use](https://obsidian.md/pricing)
- Purchasing a license is encouraged to support the project, 40% educational discount
- [Cross-platform](https://obsidian.md/download)
- Win, Mac, Linux, iOS, Android, web clippers
- Extremely versatile and customizable for many applications
- Base program expandable with several thousand official + community plugins
- Flexibility encourages uptake (see presentation on ELNs by Inge Mannaerts: researchers want highly customised solutions)
- Beginner-friendly
- Choose your level of complexity, enormous amount of user-created demos and resources, e.g. on YouTube
---
## What Obsidian is not
- Not open source
- But open data, no lock-in, data only local by default (see later)
- Not a full-fledged data collection/analysis/visualization platform
- Advanced functionality depends on community plugins that are usually maintained by individuals
- Not designed for collaboration, though it can be used for such
- Sync conflict management is very basic, may or may not be sufficient for you
- Advanced functionality again depends on community plugins
- Not based in the US
- For Obsidian Sync/Publish, whereby data are synced from hard drive to servers: European data center in Germany ([Security](https://help.obsidian.md/sync/security))
- Sync servers chosen based on IP address (see OSF presentation by Marleen Marynissen: researchers often don't change/consider default settings, so offering the right option "by default" is helpful)
---
## Basic concepts
### Basic concepts: Vaults
- Obsidian creates a layer of extra functionality over a standard file folder + subfolders on your hard drive, J-drive, Sharepoint, Onedrive, external hard drive, ...
- Your Obsidian folder(s) behave 100% like a simple folder containing files; anything you can do with a file containing folders, you can do with your Obsidian content
- A "vault" is the unit of your folder + the Obsidian functionality, plugins, etc., you added
- New "notes" you create are saved as individual markdown (.md) files
---
A vault on your file explorer:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605155806.png]]
---
Opening a vault in Obsidian:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605155835.png]]
---
A vault with markdown files:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605155927.png]]
---
### Basic concepts: Markdown
- See Erik Verraedt's LaTeX presentation: Markdown is a bit like mini LaTeX
- Obsidian uses [markdown](https://help.obsidian.md/syntax) to add *formatting/structure* and *functionality* to notes
- Formatting/structure: italic, bold, headings, lists, tables, ...
- Functionality: wikilinks, tags, metadata (properties), ...
- Plain text lightweight markup language, widely used, files can be opened with any simple text editor
- Using markdown in Obsidian: Right-click for formatting options or install [Editing Toolbar plugin](https://github.com/PKM-er/obsidian-editing-toolbar) for easily accessible buttons
---
![[Pasted image 20250617105446.png]]
---
### Basic concepts: File formats
- When you open a folder in Obsidian as a vault, only the markdown files in that folder are shown by default
- To show non-markdown files in the Obsidian file tree, enable "Detect all file extensions" in Settings -> Files and Links
- Various plugins to view, edit, or convert other file formats inside Obsidian itself
- [Docxer plugin](https://github.com/Developer-Mike/obsidian-docxer) for .docx files (view and convert to markdown for editing)
- [JSON/CSV importer plugin](https://github.com/farling42/obsidian-import-json)
- Official [Obsidian Importer](https://github.com/obsidianmd/obsidian-importer) plugin to import from other note-taking applications and formats (Apple Notes, Bear, Evernote, Google Keep, OneNote, Notion, Roam, HTML files, markdown files)
- ... (Check out plugins containing ["import"](https://obsidian.md/plugins?search=import) or "[convert"](https://obsidian.md/plugins?search=convert))
---
### Basic concepts: Templates and properties
- Create complex templates to apply to any note
- Apply properties to notes (and also templates) to create structured metadata
- Templates can also be used to gather data via the browser plugin
---
Example of a template:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605160915.png]]
---
The filled template:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605161027.png]]
---
The template in the Obsidian browser plugin:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605161158.png]]
---
### Basic concepts: Graphs
- [Graphs help](https://help.obsidian.md/plugins/graph)
- Obsidian can represent notes as a networked graph
- Graph can be customized to show note links based on wikilinks, tags, properties, etc
---
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250529191221.png]]
---
### Basic concepts: Canvases
- [Canvases help](https://help.obsidian.md/plugins/canvas)
- ![[DEMO_Project_data/DEMO_Screenshots/demo-help-vault.png]]
---
### Basic concepts: Plugins
- Extend basic functionality with "Core" plugins by Obsidian + "Community" plugins
- Install, activate, and personalize plugins in Settings
- Most plugins are open source and free
- [Search Community plugins online](https://obsidian.md/plugins)
---
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250529191613.png]]
---
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250529191722.png]]
---
### Basic concepts: Interface
- Standard:
- Left sidebar: [File tree](https://help.obsidian.md/plugins/file-explorer), [search](https://help.obsidian.md/plugins/search), [bookmarks](https://help.obsidian.md/plugins/bookmarks)
- Fun search plugin (e.g. search content from images): [Omnisearch](https://github.com/scambier/obsidian-omnisearch)
- [Various file tree alternative plugins](https://obsidian.md/plugins?search=file%20tree)
- Middle: Notes
- Right sidebar: links between notes, tags, properties, other plugin functionality
- Get creative:
- Notes can be rearranged almost without limits
- Save particular configurations as [Workspaces](https://help.obsidian.md/plugins/workspaces)
---
Basic interface:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605162125.png]]
---
Customized interface:
![[DEMO_Project_data/DEMO_Screenshots/Pasted image 20250605162426.png]]
---
### Basic concepts: Hotkeys and Command Palette
- Set Hotkeys in Settings to launch any core Obsidian or plugin-related factions
- Command palette (ctrl/cmd+P OR click icon in far left sidebar) is also a quick and easy way to find available actions and execute them
---
## Use cases
#### Obsidian for project and task management
- Templates:
- Basic functionality available as core plugin
- Intense templates: [Templater plugin](https://github.com/SilentVoid13/Templater) and other community plugins
- "(Templater) defines a templating language that lets you insert variables and functions results into your notes. It will also let you execute JavaScript code manipulating those variables and functions."
- [Workspaces](https://help.obsidian.md/plugins/workspaces)
- Wide range of calendar plugins
---
- Plugins for project and task management:
- [Tasks plugin](https://github.com/obsidian-tasks-group/obsidian-tasks): gather tasks from around your vault
- [Daily notes plugin](https://help.obsidian.md/plugins/daily-notes): generate a new daily note from a template when you open Obsidian
- [Projects plugin](https://github.com/marcusolsson/obsidian-projects): manage notes in an Airtable/Baserow/MS Lists-like interface, development recently discontinued
- [Kanban plugin](%3Chttps://github.com/mgmeyers/obsidian-kanban%3E): makes a nice kanban :)
- [Day planner plugin](https://github.com/ivan-lednev/obsidian-day-planner): show calendars (eg from outlook), time-block, show timelines
---
<https://github.com/mgmeyers/obsidian-kanban>:
![[Screen Shot 2021-09-16 at 12.58.22 PM.png]]
---
<https://github.com/ivan-lednev/obsidian-day-planner> (screenshot via [@chaemin](https://velog.io/@chaemin/obsidian-Day-Planner-plugin-%ED%85%8C%EB%A7%88-%EB%B3%80%EA%B2%BD)):
![[image.png]]
---
#### Obsidian for research data management
- Integrate RDM-related documents with the research data
- Make RDM documents part of a researcher's daily workflow
- DMPs, README files, etc., can be shown right next to the data, everything editable in one interface
- Write better, more consistent documentation
- templates
- activity logging
- intertextual links
- Easy to create data sharing pipeline
- e.g. Obsidian vault on Sharepoint folder -> RDR integration dashboard -> RDR
---
- Plugins for data management:
- [QuickAdd](https://github.com/chhoumann/quickadd): add updates to a file that isn't open (demonstration now ;)
- ![[Pasted image 20250617141608.png]]
- [Obsidian daily activity](https://github.com/trydalch/obsidian-daily-activity): log changes made to files and folders
- [Chronology plugin](https://github.com/Canna71/obsidian-chronology): Creates interactive calendar view of notes
---
#### Obsidian for gathering and annotating data
- Plugins for gathering data:
- [Web clipper](https://obsidian.md/clipper)
- Clip highlights
- Extract structured data from webpages using templates
- [Obsidian PDF++ plugin](https://github.com/RyotaUshio/obsidian-pdf-plus) for PDF annotation
- Various Zotero integration plugins (see Leah Budke's presentation for note-taking and annotation capabilities of Zotero)
- [Obsidian Zotero Integration](https://github.com/mgmeyers/obsidian-zotero-integration)
- [Zotlit](https://zotlit.aidenlx.top/)
- How researchers actually combine Zotero and Obsidian depends entirely on their preferred workflows
- Various plugins for querying APIs
- Integration plugins for a range of other tools: [Readwise](https://github.com/readwiseio/obsidian-readwise), [Kobo](https://github.com/OGKevin/obsidian-kobo-highlights-import), AI tools, git, ...
- Search for your preferred tool among the community plugins and give us feedback about if/how it integrates with Obsidian!
- Globus bv?
- ...
---
![[303649533-0c1c8ad7-1194-408f-bb47-5a847f960025.png]]
Source: https://github.com/RyotaUshio/obsidian-pdf-plus
---
#### Obsidian for exploring, analyzing, and visualizing data
- Plugins for exploring, analyzing, and visualizing data:
- [Graph view:](https://help.obsidian.md/plugins/graph) display and filter vault content in a networked graph (tip: try the timelapse video)
- [Dataview plugin](https://github.com/blacksmithgu/obsidian-dataview): annotate content with metadata (in frontmatter or inline), then query and display that metadata in a range of ways
- [Obsidian Tracker plugin:](https://github.com/pyrochlore/obsidian-tracker) track mentions in vault content with a range of different graphs (makes use of Dataview)
- [Obsidian-Charts plugin](https://github.com/phibr0/obsidian-charts): more data visualization
- [Obsidian-Chartsview plugin:](https://github.com/caronchen/obsidian-chartsview-plugin) yet more data visualization based on [Ant Design Charts](https://ant-design-charts.antgroup.com/)
- [Juggl:](https://github.com/HEmile/juggl) Interactive graph view
- ...
---
![[screenshot_v1.9.png]]
Source: https://github.com/pyrochlore/obsidian-tracker
---
![[Pasted image 20230224202045.png]]
Source: <https://charts.phib.ro/Meta/Charts/Charts+Documentation>
---
#### Obsidian for writing
---
- Obsidian can function as...
- A research wiki/knowledge base
- A knowledge management platform to feed writing projects in other apps
- An actual writing platform
- Integrate bibliography management with various Zotero integration plugins
- [Obsidian Zotero Integration](https://github.com/mgmeyers/obsidian-zotero-integration)
- [Zotlit](https://zotlit.aidenlx.top/
- [Excalidraw plugin](https://github.com/zsviczian/obsidian-excalidraw-plugin) to use [Excalidraw sketching and whiteboarding tool](https://plus.excalidraw.com/) to visualize notes, write by hand, save as markdown
---
#### Obsidian for presenting
- Plugins for presenting:
- Slides core plugin
- [Advanced Slides](https://github.com/MSzturc/obsidian-advanced-slides) adds live preview, note embeds, HTML export, ...
- [Obsidian Advanced Canvas](https://github.com/Developer-Mike/obsidian-advanced-canvas)
- [Obsidian Teleprompter](https://github.com/lumetrium/obsidian-teleprompter) adds a teleprompter to go with your presentation in the browser
---
#### Obsidian for publishing and exporting data
- Plugins for publishing an Obsidian vault as a website:
- [Obsidian Publish](https://obsidian.md/publish) (paid)
- [Collaborating on Publish site](https://help.obsidian.md/publish/collaborate) is well supported
- [Obsidian Enveloppe plugin](https://github.com/Enveloppe/obsidian-enveloppe) (free, publishes site via Github)
- [Quartz](https://quartz.jzhao.xyz/) static site generator
- Plugins for exporting text and data out of Obsidian in various formats:
- [Pandoc](https://pandoc.org/index.html) universal document converter-based plugins (e.g.[Enhancing Export](https://github.com/mokeyish/obsidian-enhancing-export))
- [Metadata Extractor plugin](https://github.com/kometenstaub/metadata-extractor): export Obsidian data to JSON
- Table to CSV exporter
- [Bulk exporter plugin](https://github.com/symunona/obsidian-bulk-exporter) to filter on metadata before exporting
- Various other export plugins
- ...
---
#### Obsidian for studying
- Plugins for studying:
- Note-taking according to various methods using templates
- Flashcards
- Various Anki integration plugins
- [Spaced Repetition plugin](https://github.com/st3v3nmw/obsidian-spaced-repetition)
---
#### Coming soon: New core plugin Bases adds MS Lists/Notion/Airtable/Baserow-like functionality
- [Bases](https://help.obsidian.md/bases) is currently in early beta
- ![[2025-05-21-bases-noshadow.png]]
---
![[Pasted image 20250617140213.png]]
---
#### Important: Make Obsidian look pretty
- [Iconic](https://github.com/gfxholo/iconic) and [Iconize](https://github.com/FlorianWoelki/obsidian-iconize) plugins
- ![[banner.webp]]
---
- Themes:
- Install new themes from Settings -> Appearance
- Then install Style Settings plugin to customize themes further
- This theme: AnuPpucin
- ![[Pasted image 20250617111830.png]]
---