Skip to content

Obsidian-VuePress Asset Path Compatibility

Obsidian-VuePress Asset Path Compatibility refers to the configuration and linking strategies required to ensure that media files and attachments function correctly when an Obsidian vault is used as the source for a VuePress static site.^[600-developer__blog__vuepress-blog__vuepress-init.md]

Path Constraints

Successful deployment requires strict adherence to specific file path conventions to prevent broken links and build errors.

  • No Chinese characters in paths: File paths and directory names cannot contain Chinese characters.^[600-developer__blog__vuepress-blog__vuepress-init.md]
  • Relative linking: Image links and other media assets must utilize relative paths rather than absolute paths to ensure portability and correct rendering in the static environment.^[600-developer__blog__vuepress-blog__vuepress-init.md]

Obsidian Configuration

To facilitate this compatibility within the Obsidian editor, specific core settings regarding attachments and links must be adjusted.^[600-developer__blog__vuepress-blog__vuepress-init.md]

The plugin obsidian-consistent-attachments-and-links is suggested for managing the "Relative Path Handling" strategy, which enforces the necessary relative structure automatically.^[600-developer__blog__vuepress-blog__vuepress-init.md]

  • [[VuePress]]
  • [[Obsidian]]

Sources

  • 600-developer__blog__vuepress-blog__vuepress-init.md^[600-developer__blog__vuepress-blog__vuepress-init.md]