Comparison

Obsidian for Images vs refern: 2026 Comparison

By refernLast updated June 202615 min read

By refern. Last updated: June 2026.

TL;DR: Obsidian is one of the best tools ever built for text-based personal knowledge management. It was not built for images, and it shows. Managing a visual reference library in Obsidian requires a plugin stack, one note per image, and workarounds that break past a few hundred images. refern is a local desktop tool built from the ground up for visual references, with a native image grid, full-text and color search, and a relationship graph designed for images, not text nodes.

Quick verdict

FeaturerefernObsidian
Image grid / galleryNative masonry grid, all layoutsNot built in; requires plugins
Image metadataTags, ratings, color labels, source, notes, EXIFRequires one markdown note per image
Color searchLocal hex-based color searchNot available
Visual similarityBuilt-in image-to-image matchingNot available
Duplicate detectionpHash-based, built inNot available
Relationship graphImages, folders, canvases, groupsText notes and wikilinks
Infinite canvasImage-first (layers, filters, crop, overlay)Text and idea board (Canvas feature)
Browser extensionHover-save, batch save, tag on saveWeb Clipper (text-focused)
Note-taking (text)Descriptions and notes on imagesFull markdown PKM, wikilinks, templates
Plugin ecosystemNone today (planned)2,700+ community plugins
Mobile appDesktop only todayiOS and Android
Price (as of 2026)$30 one-time (launch pricing)Free core; Sync $4 to $5 per month
PlatformsWindows, macOS, LinuxWindows, macOS, Linux, iOS, Android
Local-firstYes, no account requiredYes, no account required

Introduction: two local-first tools, two different jobs

Both Obsidian and refern are local-first desktop apps that put you in control of your files. Both have a graph view. Both let you arrange things on an infinite canvas. Both avoid storing your data on someone else's server by default.

That is where the similarity ends.

Obsidian is built for thinkers who work in text. Its graph connects notes, wikilinks connect ideas, and its plugin ecosystem extends that text foundation in nearly unlimited directions. Artists and designers who reach for Obsidian to organize visual references are trying to use a text-first architecture for a job it was not designed to do.

refern is built for visual references. The primary view is a masonry image grid. Every search feature, every metadata field, and the relationship graph itself are designed around images, not text documents.

refern is a desktop reference manager for artists that combines Eagle-style organization with a PureRef-style infinite canvas and an Obsidian-style relationship graph. It costs $30 one time, runs on Windows, macOS, and Linux, and does not copy your files.

What is Obsidian?

Obsidian is a local-first markdown note-taking and personal knowledge management app made by Dynalist Inc., first released in 2020. It stores notes as plain markdown files in a user-owned folder called a vault, connects them with wikilinks and bidirectional backlinks, and visualizes those connections as an interactive graph. Its 2,700+ community plugins and 548+ themes make it one of the most extensible productivity apps available. [Source: obsidian.md, moritzjung.dev plugin stats]

The core app is free with no account and no telemetry. Cross-device sync is a paid add-on at $4 per month billed annually, or $5 per month billed monthly, as of 2026 (obsidian.md/pricing). Obsidian runs on Windows, macOS, Linux, iOS, and Android.

It is genuinely excellent at what it does. The "second brain" and Zettelkasten communities have made Obsidian a standard for good reason: plain files, no lock-in, a mature plugin ecosystem, and a model of sustainable indie software that is an inspiration for refern's own approach.

What is refern?

refern is a desktop visual reference manager for artists and designers, built on Rust via Tauri v2. It runs on Windows, macOS, and Linux. It indexes your images in place inside a normal folder, so it never copies your originals. A refern workspace is just a folder: you keep ownership of every file, and deleting refern leaves nothing behind.

The app has four main pillars. A masonry image library with folders, hierarchical tags, smart folders, 14 search operators, color search by hex, and image-to-image visual similarity. An infinite canvas with layers, shapes, text, freehand drawing, image filters, non-destructive crop, and a pin-window-on-top overlay mode. A relationship graph that maps connections between images, folders, canvases, and groups. And a browser extension for Chrome, Firefox, and Safari that saves images from any website directly into your organized library.

refern costs $30 one-time (launch pricing, going to $35 about two months after launch). One license covers up to 3 devices, commercial use included. There is a 30-day free trial with no account required.

Obsidian

Obsidian's organization is folder-based and tag-based, with nested tags and the file explorer. For text notes, this is powerful and natural. For images, the architecture creates friction.

Images in Obsidian are attachments: files stored in a designated attachments folder inside the vault. There is no native gallery view, no thumbnail grid, and no metadata layer on those attachment files. To add tags, a source URL, or a rating to an image, you must create a separate markdown note for each image and embed the image inside it. At a few dozen images this is manageable. At a few hundred it becomes impractical. A Medium author who attempted this workflow documented three core limitations: "images aren't treated as knowledge elements," "no support for tags, descriptions, or source info," and "no centralized visual management layer." They found the approach broke down past 900 images. [Source: medium.com images-as-notes article]

A 2021 thread on the official Obsidian forum titled "Creating an image gallery" found no built-in solution. The thread remains unsolved. [Source: forum.obsidian.md image gallery thread]

refern

refern's entire interface is built around image organization. Every folder is automatically a masonry gallery. Tags are first-class objects with hierarchies, tag groups, linked tags, and macro shortcuts for bulk tagging. Search uses SQLite FTS5 full-text search plus 14 inline operators: type:image, tag:architecture, rating:>=4, color:#3a5f8a, is:duplicate, derived:, linked:, and more. Color search lets you click a hex value and find every image in your library that matches that palette, entirely locally with no API calls. Image-to-image visual similarity surfaces reference images that look like a selected one.

Smart folders let you save any search query as a live folder that updates automatically as your library changes.

Verdict: For image organization at scale, refern has no peer in this comparison. Obsidian requires significant workaround effort that does not scale. If organizing, tagging, and searching a library of visual references is your goal, this is the most decisive difference between the two tools.

Canvas and boards

Obsidian

Obsidian added Canvas in December 2022 as an infinite whiteboard for arranging notes, images, PDFs, and web content. Cards can be edited inline. Connections between cards can be labeled and colored. It exports to image and uses an open JSON Canvas format.

For brainstorming text ideas in a spatial layout, Obsidian Canvas works well. For visual reference boards, it shows strain. Artists in the Obsidian forum have requested features that have not been addressed: grayscale toggle, nearest-neighbor rendering for pixel art, proper image scaling by resolution, and mass import from disk. A 2023 forum thread on these requests was closed by a moderator without resolution. [Source: forum.obsidian.md canvas-for-artists thread] There is no search within a canvas board, no per-image metadata sidebar, and no always-on-top overlay mode for use alongside other applications.

refern

refern's canvas is designed around images. You can import images from your library or from disk, arrange them in layers with fractional z-ordering, group them with named and colored group backgrounds, and crop non-destructively. Text blocks, 9 shape types, freehand drawing with the perfect-freehand stroke model, and color swatch elements round out the canvas. Image filters let you adjust how references look on the board without modifying the original file.

The pin-on-top mode is the PureRef use case, built directly into refern: you can pin the refern window on top of any other application, adjust transparency, and enable mouse clickthrough so clicks pass through to the app underneath. This lets you use refern as a floating reference overlay over Blender, Photoshop, or any other tool.

Verdict: For ideas and notes arranged spatially, Obsidian Canvas is capable. For visual reference boards with image-specific controls, refern's canvas is purpose-built. Artists who currently use PureRef for the overlay use case will find that use case covered directly in refern.

Relationships and graph view

Obsidian

Obsidian's graph view is the most mature knowledge graph implementation in personal software. It shows the connections between all your notes based on wikilinks and backlinks, with filtering by depth, tag groups, and color coding. For visualizing how your ideas, research, and writing connect across a text-based knowledge base, it is excellent.

The graph does not understand images as distinct objects. An image embedded in a note appears as a property of that note, not as its own node. You cannot navigate from an image to related images via the graph, or see that two folders both contain reference images of the same subject.

refern

refern's relationship graph is built for visual assets. Every image, folder, canvas, and group is a node. Typed entity links create edges: member-of (group membership), derived-from (crop provenance), placed-in-canvas (canvas references), and cross-reference (manual direct links). The Linked References sidebar shows, for any selected image, everything that references it, everything it has been cropped from, every canvas it appears in, and everything directly linked to it.

The mental model will feel familiar to Obsidian users: bidirectional backlinks, a navigable graph, and typed relationships between entities. The difference is that the entities are images, canvases, and folders rather than text notes.

One refern alpha user described it as "what if Obsidian had pictures instead of notes." That framing captures what the relationship graph is doing here: the same philosophy applied to a visual library.

Verdict: Obsidian's graph is unmatched for text-based knowledge. refern's graph is the only tool in this category that applies that same relationship model to a visual reference library. For an artist who wants to understand how their references connect, refern's graph fills a gap that currently has no alternative.

Pricing

refernObsidian
Core app$30 one-time (launch pricing, going to $35 in about two months)Free
Sync / cross-deviceNot yet available (planned Phase 2)$4 to $5 per month (as of 2026, obsidian.md/pricing)
MobileNot available (desktop only today)Included with free app
Trial30 days, no accountFree forever
Devices per licenseUp to 3Single device free; Sync required for multi-device
Commercial useIncludedIncluded (commercial license made free February 2025)

Obsidian wins on upfront cost: the core app is free, full stop. If you only need one device and no sync, Obsidian costs nothing.

The calculus changes over time. For anyone who needs cross-device access, Obsidian Sync at $4 to $5 per month costs $48 to $60 per year, which exceeds refern's one-time price within a year or two. However, refern does not yet have cloud sync at all. Cross-device visual reference access is a planned paid feature (Phase 2). Today, refern is a single-user, single-device tool, and Obsidian has a full sync solution available now.

Full feature comparison

CapabilityrefernObsidian
Image grid / gallery viewNative masonry, justified, horizontal layoutsNot built in
Thumbnail generationAutomatic WebP thumbnails for all imagesNone
Image tagsHierarchical tags, tag groups, linked tags, macrosRequires plugin + one note per image
Ratings (1 to 5 stars)NativeRequires manual YAML frontmatter per image
Color labels9 color labelsNot available
Descriptions and notesNative on any imageRequires a separate markdown note per image
Source URL and creatorNative fieldsNot available natively
EXIF/XMP metadata importReads embedded metadata on importNot available
Full-text searchFTS5 with 14 operatorsFilename search only for images
Color search by hexYes, local, no APINot available
Visual similarityLocal image-to-image matchingNot available
Duplicate detectionpHash-basedNot available
Smart folders (saved searches)YesDataview plugin (text-focused)
Infinite canvasImage-first with layers, filters, cropCanvas (text and idea-focused)
Always-on-top overlayYes (pin, opacity, clickthrough)Not available
Relationship graphImages, folders, canvases, groupsNotes and wikilinks
Typed entity linksYes (grouped, derived, placed, cross-ref)Wikilinks only
Browser extensionHover-save, batch save, tag on saveWeb Clipper (text-focused)
Eagle importYes (folders, tags, ratings, metadata)Not available
Desktop screenshot toolYesNot available (plugins only)
Note-taking (text)Descriptions and notes on images onlyFull markdown PKM
Wikilinks and backlinksNot applicableCore feature
Plugin ecosystemNone today (planned)2,700+ community plugins
ThemesNot applicable548+ community themes
MobileNot availableiOS and Android
Web appNot availableNot available
Cross-device syncNot yet available (planned)$4 to $5 per month (as of 2026)
Local-firstYes, no accountYes, no account
Open file formatWorkspace is a normal folder; canvas files are JSONMarkdown + JSON Canvas (fully open)
PlatformsWindows, macOS, LinuxWindows, macOS, Linux, iOS, Android
Community sizeGrowing (Discord approximately 1,500 members)Large (Discord approximately 190,000, Reddit approximately 329,000 members)

Who should choose refern

refern is the right choice if your primary need is managing, searching, and using a library of visual references.

Choose refern if you:

  • Work as an artist, illustrator, concept artist, game developer, or designer and keep a library of reference images.
  • Want to search your images by tag, color, rating, source, or visual similarity without setting up plugins or building workarounds.
  • Use PureRef as a reference overlay and want that functionality combined with your image library.
  • Currently run Obsidian + Eagle + PureRef as three separate tools and want to consolidate the visual-reference half of that stack.
  • Care about a graph view that shows how your visual references relate to each other, not just how your text notes connect.
  • Want to own your images without any app copying or locking them.

refern is not the right tool if you need text-heavy knowledge management, a second brain for research and writing, a mobile app, or a cross-device sync solution today.

Who should choose Obsidian

Obsidian is the right choice for text-based personal knowledge management, and it has no serious competition in that domain.

Stay on (or switch to) Obsidian if you:

  • Think in text and want a "second brain" for research, writing, ideas, and notes.
  • Need a plugin ecosystem to extend your tool in every direction imaginable.
  • Want iOS and Android apps with sync built in.
  • Need collaborative shared vaults.
  • Value the free-core-app pricing model.
  • Are a developer, researcher, or writer whose primary assets are documents, not images.

Obsidian is also worth keeping alongside refern. The "Obsidian for text, refern for visuals" combination is exactly what several refern alpha users described as their preferred setup.

Switching from Obsidian to refern (or adding refern)

Most users will add refern rather than replace Obsidian, since the tools handle different things. But if you have been using Obsidian Canvas or an "images as notes" plugin stack to manage visual references, here is what to expect when you move that work to refern.

What transfers easily:

Your image files are just files in a folder. Point refern at the folder where your images live (inside or outside your Obsidian vault), and refern will index them in place without moving or copying anything. Your originals stay where they are, untouched.

If you have been storing metadata in markdown frontmatter, you will need to re-enter tags and ratings in refern. refern does read EXIF, IPTC, and XMP metadata embedded in image files on import, so if your images carry embedded metadata, refern will pick it up automatically.

If you are coming from Eagle, refern has a dedicated Eagle import path that brings over folders, tags, ratings, source URLs, and notes.

What does not transfer:

Text notes that live in separate markdown files do not have an equivalent in refern. refern supports descriptions and notes on images, but it is not a markdown editor. Keep Obsidian for that.

Wikilinks between notes have no equivalent in refern's relationship model. refern's typed entity links connect images and folders to each other, not notes to images.

Zero lock-in:

refern never moves your files. Stopping using refern leaves your images exactly where they were. The SQLite index and thumbnail cache sit inside your workspace folder and can be deleted at any time without affecting your originals.

See what makes a good reference manager for more on how local-first tools handle file ownership.

Frequently asked questions

Can Obsidian organize images?

Obsidian can store images as vault attachments, but there is no native gallery view, no image tagging system, and no visual search. The only workaround is creating a separate markdown note per image with plugin-based frontmatter, documented as impractical past a few hundred images. It is not designed for image library management.

Does refern do notes and text like Obsidian?

refern is focused on visual references. You can add text descriptions, notes, source URLs, and creator fields to any image or folder, and place text blocks on a canvas. It is not a markdown note-taking app. For text-heavy knowledge management, Obsidian remains the better tool.

Does refern have a graph view like Obsidian?

Yes. refern has a relationship graph view that shows connections between images, folders, canvases, and groups based on typed entity links (grouped, derived-from, placed-in-canvas, cross-reference). It is designed for visual assets rather than text notes, but the mental model is similar.

Is Obsidian free? How does the pricing compare?

Obsidian's core app is free. Cross-device sync costs $4 to $5 per month (as of 2026, obsidian.md/pricing). refern costs $30 one-time (launch pricing, going to $35 about two months after launch) with no subscription and up to 3 devices per license.

Can I use Obsidian and refern together?

Yes, and many users do exactly this. Obsidian handles text notes, research, and writing. refern handles visual references, moodboards, and image organization. Several refern alpha users described this as their preferred setup, with one calling refern 'what if Obsidian had pictures instead of notes.'
  • $30 one-time, no subscription
  • Windows, macOS, Linux
  • Local-first and private
  • 10,000+ creatives
  • Community on Discord
“Organization and search like Eagle cool, canvas from PureRef.”
An early refern user

Try it yourself

One library for your references, with a canvas built in.

refern keeps your images organized and searchable, gives you an infinite canvas to arrange them, and read your files as is. $30 one-time, lifetime updates.

No account required. Cancel anytime during the trial.

Sources

  1. 1.Official homepage: features, positioning, platform list
  2. 2.Sync $4/mo annual or $5/mo monthly, Publish, Catalyst pricing (as of 2026)
  3. 3.Three core image limitations; workaround impractical at 900+ images
  4. 4.Artist Canvas feature requests (grayscale, nearest-neighbor, scale) unresolved
  5. 5.Image gallery forum thread (2021), no built-in solution
  6. 6.2,700+ community plugins, 100M total downloads
  7. 7.Mobile sync complaints, image path breakage
  8. 8.Designers forum thread on Obsidian limitations for visual work