Cross-post references
Link from one Valeon post to another in a way that survives renames, slug changes, and moves between authors.
Why cross-post links are different
A normal link is a full URL — something like https://valeon.blog/2026/05/21/why-essays-matter. If the post’s author, date, or slug ever changes, that link breaks.
A cross-post reference points to the post itself, not its URL. When the post is rendered, the reference is rewritten to the current address of the linked post. If the post moves, the link keeps working.
Adding one from the slash menu
Type /post in the editor. A search box appears — start typing a post title and pick the one you want from the list. The cross-post link is inserted at your cursor.
Adding one from the link dialog
If you’re already in the link dialog (either from the toolbar or with ⌘K), switch to the Posts tab. Same search as the slash menu — pick a post, set the link text, and confirm.
Pasting a Valeon URL
If you paste a normal Valeon URL into the editor, the editor looks the post up and converts the link into a cross-post reference automatically. You don’t need to do anything extra.
If the lookup fails (the URL is wrong, the post hasn’t been published yet, or the slug is from a redirect), the URL is left untouched. Pre-publish checks will flag any links that didn’t resolve.
What it looks like under the hood
A cross-post reference is stored as a special URL — valeon:post:abc123 — where the last part is the post’s permanent ID. When the page is rendered, every reference is looked up and replaced with the current address of that post.
You don’t need to deal with this format directly — the editor and the Obsidian plugin handle it for you. It’s just useful to recognise if you see it in source mode or in your Obsidian vault.
Linking to a draft