https://github.com/pushfoo/misc-obsidian-helpers
Tools for working with Obsidian and related Markdown dialects.
https://github.com/pushfoo/misc-obsidian-helpers
Last synced: about 1 month ago
JSON representation
Tools for working with Obsidian and related Markdown dialects.
- Host: GitHub
- URL: https://github.com/pushfoo/misc-obsidian-helpers
- Owner: pushfoo
- Created: 2026-05-15T19:05:26.000Z (2 months ago)
- Default Branch: dev
- Last Pushed: 2026-05-15T19:13:45.000Z (2 months ago)
- Last Synced: 2026-05-15T21:56:22.407Z (2 months ago)
- Language: Python
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Misc Obsidian Helpers
Tools for working with [Obsidian][] and related Markdown dialects.
## Current Features
Barely there unless you're willing to import. Set up in a venv, then:
```shell
$ obsidian-util --list vault
Your Vault /home/You/Vaults/Your Vault
```
Or:
```shell
$ obsidian-util --info file --name "Your File"
ObsidianFile(name='Your File', system_path=PosixPath('/home/You/Vaults/Your Vault/Your File.md'), lazy=True)
```
## Intended Audience
Do you like these things?
1. [Obsidian][]
2. [Python][] 3.13+
3. *Deterministic* and *explainable* automation
Are you okay with installing from source?
[Obsidian]: https://obsidian.md/
[Python]: https://www.python.org/
## License
TBD. See next section.
## Purpose
**TL;DR:** 6:43-44
Also known as:
> Things made with spite taste bad
### Goals
> Slow is Smooth, Smooth is Fast
Respect ~~[Chesterton's fence][]~~ my fence:
1. Help me put my notes into [Obsidian][] the right way
2. Help people who want the same things
3. Don't break things too much
[Python]: https://www.python.org/
[Obsidian-flavored Markdown]: https://obsidian.md/help/obsidian-flavored-markdown
[Chesterton's fence]: https://en.wiktionary.org/wiki/Chesterton%27s_fence
### Anti-Goals
"Anti-goals" are things to be avoided. These are not current goals
1. "Scale"
2. "Disruption"
3. Fads (non-determinism, package manager [Jenga][], etc.)
> [!NOTE]
> The [uv][] package manger earned its place.
> It is both faster and more reliable than `pip`.
[Jenga]: https://en.wikipedia.org/wiki/Jenga
[uv]: https://docs.astral.sh/uv/