https://github.com/sapegin/obsidian-title-sync
Obsidian plugin that synchronies title in Markdown when file is renamed
https://github.com/sapegin/obsidian-title-sync
obsidian obsidian-plugin
Last synced: about 2 months ago
JSON representation
Obsidian plugin that synchronies title in Markdown when file is renamed
- Host: GitHub
- URL: https://github.com/sapegin/obsidian-title-sync
- Owner: sapegin
- License: mit
- Created: 2025-11-16T09:03:12.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-11-16T09:35:06.000Z (about 2 months ago)
- Last Synced: 2025-11-16T11:16:44.653Z (about 2 months ago)
- Topics: obsidian, obsidian-plugin
- Language: JavaScript
- Homepage:
- Size: 51.8 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- Contributing: Contributing.md
- License: License.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Title Sync Obsidian plugin
[Obsidian](https://obsidian.md) plugin that updates first-level heading in Markdown when file is renamed
[](https://sapegin.me/book/)
## What this plugin does
Whenever you rename a file, this plugin does the following:
1. If the old filename matches the first-level heading (`#`) in Markdown, it updates the heading to match the new filename.
2. If there’s no first-level heading in Markdown, it adds a heading that matches the new filename.
3. If the first-level heading in Markdown doesn’t match the old filename, it does nothing.
**Note:** This plugin is intended to be used with disabled “Show inline title” option in Obsidian.
## Motivation
I want my Markdown files to be self-contained and have a first-level heading (`# Pizza`), so they work look good in any app, not just in Obsidian.
Also, sometimes I want to use special characters in the title (such as `():`) that aren’t allowed in filenames. This is only possible with a first-level heading, which creates inconsistent notes with default Obsidian settings (when the “Show inline title” option is enabled).
This plugin was inspired by the [Title renamer](https://github.com/stroiman/obsidian-title-sync) plugin.
## Sponsoring
This software has been developed with lots of coffee, buy me one more cup to keep it going.
## Contributing
Bug fixes are welcome, but not new features. Please take a moment to review the [contributing guidelines](Contributing.md).
## Authors and license
[Artem Sapegin](https://sapegin.me) and [contributors](https://github.com/sapegin/obsidian-title-sync/graphs/contributors).
MIT License, see the included [License.md](License.md) file.