Skip to content

Allow configuring a nested vault root in VS Code #474

Description

@jav-ed

Problem

In VS Code, markdown-oxide appears to use the opened workspace root as the vault root. This makes it hard to use markdown-oxide in repositories where the Markdown documentation vault intentionally lives in a nested folder.

Example repo layout:

repo/
  Project_Manag/
    Docs/
      .moxide.toml
      doc_Start.md
      Descr/
        overview.md

Inside Project_Manag/Docs/doc_Start.md, this link is correct relative to the docs vault:

[Overview](Descr/overview.md)

But when opening the full repo in VS Code, markdown-oxide reports it as unresolved, apparently because the effective vault root is repo/ instead of repo/Project_Manag/Docs.

Desired behavior

Allow the VS Code extension or server config to define a nested vault root, for example:

vault_root = "Project_Manag/Docs"

or have the VS Code extension detect the nearest .moxide.toml / .obsidian folder and start the language server with that as the root, similar to root marker behavior in other LSP clients.

Why this matters

For documentation-heavy software repos, the project root and the Markdown vault root are often not the same folder. Opening only the docs folder works around the issue, but it loses the rest of the repository context in the editor.

Current workaround

Open Project_Manag/Docs as the VS Code workspace root, or disable unresolved diagnostics. Neither is ideal.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions