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-maas708 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".
HealthExcellent
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
3 months ago
Created
12 months ago
Updates
5 releases
Downloads
708
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).

Vault Changelog

Maintain a changelog of recently edited notes.

Notebook Navigator

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

BRAT

Easily install a beta version of a plugin for testing.

Homepage

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

Claudian

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

Local REST API with MCP

Unlock your automation needs by interacting with your notes over a secure REST API.

Fast Note Sync

Real-time sync of your vaults across server, mobile, and web; shareable with anyone; supports REST and MCP integrations to build your personal AI knowledge base.