Creating Link Aliases in Logseq

Preslav Rachev
2 min readApr 10, 2022


Logseq has become my latest obsession and quickly replaced my other “ultimate-note-dump” solutions. It has an extremely vibrant community, but (no offense) not always adequate documentation. Turns out, many things one might be looking for have already been implemented, but one only finds out the right way to do them via the community.

For me, one of these things was link aliasing. Let me explain what I mean. We all know that Logseq (similar to Obsidian, Roam Research, and others) supports a wiki-style way of linking between pages. In simple words, referring to a [[page]] using double square brackets will automatically add a link to it.

The problem I’ve had was linking to a page in the context of a sentence or block of fluent text. So, I’d usually do something like that:

Indeed, not the nicest idea. It fulfills the part of linking to a page, but breaks the fluency of the text.

Turns out, the real solution was right in front of my nose, and I’d never bothered to try it. What if instead of linking to a [[page]], we do it like this instead:

Every [model]([[Django/Models]]) class in Django has its inner `Meta` class

And indeed, it works like a charm. I no longer need to decorate my text with superfluous links. I can do that as part of the text itself.

Hope this helps others too.

Originally published at on April 10, 2022.



Preslav Rachev

I am a genuinely curious individual on a mission to help digital creators and startups realize their vision. Follow my journey: