logseq-asset-linker

name	logseq-asset-linker
description	Construct Logseq asset links: convert a macOS/absolute file path or a Logseq namespaced page name into a relative Markdown link (or file:/// link) into the graph's assets/ directory. Use when the user gives a file path or [[Namespace/Page]] and wants the asset/image/PDF link, an asset filename, or an asset folder path. Do not use for ordinary page wikilinks (logseq-core / logseq-link-hygiene).

Logseq asset linker

Produce copy-pasteable asset links relative to a page in pages/.

Quick rules

• Relative links into assets/ are formed from a typical page location (logseq/pages/somepage.md), so they start ../assets/....
• Image link: ![name](../assets/path). File link: [name](../assets/path). Folder link: [name](../assets/folder).
• Use file:/absolute/path only when the user explicitly wants a direct file link.
• For namespaced assets, convert / → __ (double underscore) in the filename, and sanitize non-alphanumeric chars to _.
• Always return the result as a code snippet for easy copying.

Read references/asset-link-construction.md for the full use cases, examples, and the file:/// handling rules.