docs: clarify properties prefix rule and add CLI/Bases prerequisites#84
Open
hst368 wants to merge 1 commit into
Open
docs: clarify properties prefix rule and add CLI/Bases prerequisites#84hst368 wants to merge 1 commit into
hst368 wants to merge 1 commit into
Conversation
obsidian-bases: - Document the asymmetric prefix rule: in `properties:` config block, frontmatter keys must use `note.` prefix or `displayName` is silently ignored (column header shows raw field name). In `order`, `filters`, `groupBy`, `sort`, the bare form still works. - Update Schema and Task Tracker / Reading List examples to show the `note.` prefix in `properties:` blocks. - Add a Prerequisite note: Bases is a core plugin and may need to be enabled in `core-plugins.json` for vaults that predate v1.9. - Add a Troubleshooting entry for the displayName-ignored symptom. obsidian-cli: - Add Prerequisites section: Obsidian on macOS has two version numbers (asar bundle auto-updates, installer does not). The in-app updater can report "latest" while installer is too old to ship the CLI binary. Document how to check the installer version and reinstall. - Add health check command and a fallback path for environments where the CLI isn't available. These are documentation-only changes informed by hands-on use that hit both gotchas (displayName silently ignored, CLI missing despite "latest version" prompt).
sigrunixia
added a commit
to sigrunixia/obsidian-skills
that referenced
this pull request
May 23, 2026
sigrunixia
added a commit
to sigrunixia/obsidian-skills
that referenced
this pull request
May 23, 2026
…sections Resolves conflict with PR kepano#84. Takes PR kepano#36's comprehensive footnote examples (named + inline), merges Property Types table and Lists of Wikilinks subsection into the Properties section, and adds Horizontal Rules and HTML Content sections. Removes duplicate sections introduced by the conflict. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
sigrunixia
added a commit
to sigrunixia/obsidian-skills
that referenced
this pull request
May 23, 2026
sigrunixia
added a commit
to sigrunixia/obsidian-skills
that referenced
this pull request
May 23, 2026
…sections Resolves conflict with PR kepano#84. Takes PR kepano#36's comprehensive footnote examples (named + inline), merges Property Types table and Lists of Wikilinks subsection into the Properties section, and adds Horizontal Rules and HTML Content sections. Removes duplicate sections introduced by the conflict.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Two documentation fixes informed by hands-on use that hit real gotchas.
obsidian-bases: theproperties:prefix asymmetry is silentIn
order,filters,groupBy, andsort, frontmatter properties can be referenced bare (status) or prefixed (note.status) — both work.But in the top-level
properties:configuration block, the bare form is silently ignored:displayNamedoes not apply, and the column header shows the raw frontmatter field name. The asymmetry isn't documented anywhere and is hard to debug because there's no error or warning.This PR:
note.<field>in theirproperties:blocksobsidian-bases: Bases plugin may not be enabledBases is a core plugin since v1.9, but in vaults that predate v1.9 the plugin can be disabled by default —
core-plugins.jsonmay show"bases": false. The symptom is that.basefiles don't appear in the file tree at all and macOS Finder asks "what app should open this?" when double-clicked. Added a one-paragraph Prerequisite note.obsidian-cli: the "latest version" trap on macOSObsidian on macOS has two independent version numbers:
/Applications/Obsidian.appdoes notThe in-app "check for updates" only covers the asar. So you can be on "latest 1.12.7" by Settings, but still have a stale installer that lacks the CLI binary, and
which obsidianreturns nothing.Added a Prerequisites section that documents:
Scope
Documentation only. No behavior changes, no formula/syntax changes. Two files modified.
Test plan
displayNamesilent-ignore symptom on Obsidian 1.12.7 with bare frontmatter keys; confirmednote.<field>fixes itcore-plugins.jsonshowed"bases": false🤖 Generated with Claude Code