Skip to content

VuePress path and asset constraints

When setting up and maintaining a [[VuePress]] site, particularly when integrating with tools like [[Obsidian]], specific file naming and asset linking conventions must be observed to ensure the site builds and functions correctly.

File Naming Constraints

Filenames within the project must adhere to strict character usage rules. Paths cannot contain Chinese characters.^[600-developer-blog-vuepress-blog-vuepress-init.md] Using non-ASCII characters in file paths will likely result in build errors or deployment issues.

Asset Linking

References to media assets (such as images) must utilize relative paths.^[600-developer-blog-vuepress-blog-vuepress-init.md] Absolute paths may break when the site is deployed or the directory structure changes. To maintain consistency and facilitate this relative linking behavior—especially for users managing content in [[Obsidian]]—plugins such as obsidian-consistent-attachments-and-links are recommended.^[600-developer-blog-vuepress-blog-vuepress-init.md]

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

Sources

^[600-developer-blog-vuepress-blog-vuepress-init.md]