Re:Org-roam: Rudimentary Roam replica with Org-mode
by awake on Sunday April 05, 2020 @04:42PM
(#22788539)
curious. how you deal with slugging topics with "Punctuation!". Also do both types of links provide the same affordances? If I write [[Topic]] vs [Topic](topic.md) is there any semantic difference?
Re:Org-roam: Rudimentary Roam replica with Org-mode
by ericax on Sunday April 05, 2020 @05:01PM
(#22788702)
Not sure I understand the first question, but if the topic itself contains "!", that's fine by the app, as long as it doesn't use the characters that the OS doesn't allow (like slashes).
The vertical bar syntax is also supported, so you can write [[Topic|display name]] and "display name" will show.
I usually leave punctuation out of the link, like `[[name]]'s`.
> Also do both types of links provide the same affordances? If I write [[Topic]] vs [Topic](topic.md) is there any semantic difference?
No semantic different.
UX-wise, right now [[ auto-completes from the list of files in your folder, whereas [Topic]( doesn't.
There are 3 main reasons:
1) At least to me, "[Topic](Topic.md)" is the most typical case, where the name of the link is the same as the file name without the ".md", so I feel like not repeating the title twice is better.
Markdown supports "[](Topic.md)" but IMO the syntax doesn't look as nice.
2) Easier to distinguish between internal links and external links.
3) Personally, I think "[[note]]" blends into the sentence better.
[[wiki style links]] are not as portable as standard Markdown links, I have to admit that. We will support "[A File](a-file.md)" as well for maximum portability, and possibility provide conversion utilities if you decide to move away from the wiki style link syntax.