gitwtfhub

wtf is obsidian-one-file?

rcanand/obsidian-one-file — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 2/5Setup · moderate

TL;DR

An Obsidian plugin that edits any markdown file on your computer in place, without copying it into the vault.

Mindmap

mindmap
  root((One File plugin))
    What it does
      Links to files on disk
      Edits write through
      Focus mode writing
    Tech stack
      TypeScript
      Obsidian API
      Electron
    Use cases
      Edit files outside vault
      Distraction free writing
      Clean up broken links
    Audience
      Obsidian users
    Limitations
      Desktop only
      Symlinks don't sync
      Needs disk access permissions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Edit markdown files stored anywhere on your computer directly from Obsidian.

REASON 2

Write in a distraction-free focus mode that hides sidebars and toolbars.

REASON 3

Keep a single source file in sync without duplicating it into your vault.

REASON 4

Clean up broken links after a source file is moved or deleted.

What's in the stack?

TypeScriptObsidian APIElectron

How it stacks up

rcanand/obsidian-one-file0xradioac7iv/tempfs52191314/web-agent-proxy-sdk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 5min

Desktop only, may require granting Full Disk Access on macOS for protected folders.

Wtf does this do

One File is a plugin for the note-taking app Obsidian that lets someone edit any markdown file already on their computer directly from inside their Obsidian vault, without moving or copying that file into the vault first. Instead of duplicating the file, the plugin creates a link to the original file on disk, so any edit made in Obsidian is actually saved back to the real file in its original location. This is desktop-only software for Mac, Windows, and Linux, and it will not install or run on the mobile version of Obsidian. Once installed, users can open an existing markdown file through a file picker or by typing its path directly, and the plugin will create a new file at that path if one does not exist yet. There is also a focus mode command that hides the sidebars, tabs, and status bar for distraction-free writing, and a cleanup command that removes links pointing to files that were deleted or moved. When a file is opened, the plugin creates a link inside a visible folder in the vault that mirrors the file's original location on disk, so users can see exactly which files the plugin is tracking. The README is clear about some limitations. Because these links are filesystem symlinks, cloud sync services like iCloud, Dropbox, or Obsidian Sync generally do not carry them between devices, so the plugin is meant for editing files on the same computer where they live. Files in protected folders on macOS, like Documents, need Obsidian to be granted Full Disk Access first. Since the link folder is visible in the vault, linked files also show up in Obsidian's search and graph view unless manually excluded. The plugin is built by an independent developer, Anand Ramanathan, who also links to a few of his other projects and an optional donation page.

Yoink these prompts

Prompt 1
Walk me through installing the One File plugin into my Obsidian vault manually.
Prompt 2
Explain why my linked files aren't syncing to my other device through iCloud or Obsidian Sync.
Prompt 3
Help me grant Obsidian Full Disk Access on macOS so I can edit files in my Documents folder.
Prompt 4
Show me how to exclude the One File mirror folder from Obsidian's search and graph view.

Frequently asked questions

wtf is obsidian-one-file?

An Obsidian plugin that edits any markdown file on your computer in place, without copying it into the vault.

What language is obsidian-one-file written in?

Mainly TypeScript. The stack also includes TypeScript, Obsidian API, Electron.

How hard is obsidian-one-file to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is obsidian-one-file for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.