macana

Static site generator for Obsidian Vault


createdAt: 2024-04-15T23:00:00+09:00

updatedAt: 2024-04-15T23:00:00+09:00

Supported path resolutions

Relative

Relative link is the best format, especially if you consider compatibility to other tools.

[Overview](../Overview.md)

Overview

Without file extension

Although you can omit file extensions in the file path, this is not recommended if you care compatibility or portability. This also affects performance.

[Overview](../Overview)

Overview

Absolute

Absolute paths are resolved from the Vault root.

[Overview](/en/Overview.md)

Overview

Without file extension

You can omit file extensions in the absolute form, too. This affects performance.

[Overview](/en/Overview)

Overview

Shortest path when possible

Macana also supports “Shortest path when possible” links, which is the default value for the newer Obsidian versions. When Vault has more than one file having same name, resolution will result in error.

[Overview](Overview)

Overview

Limitation

Filename confusion on extension-less path

When you have more than one file with same file stem (filename without extension part), you can’t refer to the file without extension.

For example, if you have both Foo/Bar.md and Foo/Bar.jpg on a same directory, below Foo/Baz.md results in a build error, because Macana cannot decide which file to use.

[Bar](./Bar)