git404hub

what is obsidian-one-file fr?

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.

vibe map

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

what do people make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

TypeScriptObsidian APIElectron

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 5min

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

in plain english

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.

prompts (copy fr)

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

what is obsidian-one-file fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.