Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Sync-safe file names

j-maasj-maas844 downloads

Ensures all file names can be synced accross all platforms.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates5

Ensure your Obsidian files can always be synced across all your devices.

What is the problem?

Sometimes I have special characters in my file names on my desktop, like ?. When I open the app on my phone, I get a notification that says that some of those files cannot be synced. Those special characters, like ?, prevent the file from being synced to my phone.

This plugin helps you rename all your files to only contain safe characters, by replacing all unsafe characters with a hypen, -. So "Invalid?.md" becomes "Invalid-.md". The plugin can also automatically rename all new files you create or change the name of, but it will never overwrite an exisiting file.

Other plugins like Obsidian Filename Linter Plugin require manual execution. This plugin runs automatically to ensure all newly created files have safe names.

Getting started

  1. Install the plugin.
  2. Automatic renaming is activated by default. You can change this in the plugin settings.
  3. Open a new file, edit the content and run the command "Insert report of all unsafe file names".
  4. If you are happy with the plan, run the command "Rename all files to be sync-safe".
HealthGood
ReviewSatisfactory
About
Rename files to only use sync-safe characters by replacing unsafe characters with hyphens, e.g., "Invalid?.md" → "Invalid-.md". Sanitize newly created or renamed files automatically and generate a report of unsafe filenames before applying changes; never overwrite existing files.
FilesSyncingAutomation
Details
Current version
1.1.0
Last updated
4 months ago
Created
Last year
Updates
5 releases
Downloads
844
Compatible with
Obsidian 1.4.4+
Platforms
Desktop, Mobile
License
0BSD
Report bugRequest featureReport plugin
Author
j-maasj-maas
github.com/j-maas
GitHubj-maas
  1. Community
  2. Plugins
  3. Files
  4. Sync-safe file names

Related plugins

Advanced URI

Control everything with URI.

QuickAdd

Quickly add new notes or content to your vault.

Google Drive Sync

Syncs a vault into Google Drive for cross-platform use (works for iOS).

Nutstore Sync

Sync your vault with Nutstore (坚果云) using WebDAV protocol.

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Homepage

Open a note, base, or workspace on startup, or set it for quick access later.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

BRAT

Easily install a beta version of a plugin for testing.

Claudian

Embeds Claude Code/Codex and other local Agents as AI collaborators in your vault.

Self-hosted LiveSync

Sync vaults securely to self-hosted servers or WEBRTC.