Hi guys! Is there any way to use triple backticks ...
# announcementsz
zkeme
09/27/2019, 5:13 PMHi guys! Is there any way to use triple backticks in KDoc and still have links inside?
r
Ruckus
09/27/2019, 5:23 PMWhy would you want this? Generally (as far as I'm aware) you want your code samples to be copy-paste able by users. Adding links seems counterproductive.
z
zkeme
09/27/2019, 5:29 PMimage.png
zkeme
09/27/2019, 5:29 PMI want to do something like that in the docs of that interface.
zkeme
09/27/2019, 5:30 PMIf I don't use ``` then the formatting is not kept. If I use it, then the link is lost.
zkeme
09/27/2019, 5:30 PMSorry If I wasn't clear before 🙂
r
Ruckus
09/27/2019, 5:31 PMAh, you're not using it for code. Fair enough. It seems like a bit of a hack though. That's not really the purpose of ``` as far as I'm aware.
z
zkeme
09/27/2019, 5:32 PMMaybe this is an IDE thing, not sure.
zkeme
09/27/2019, 5:34 PMHere is what it is like if I don't use the ```
zkeme
09/27/2019, 5:34 PMimage.png
r
Ruckus
09/27/2019, 5:34 PMI think it's more an issue that you're trying to use things improperly. You should probably just use
<table>z
zkeme
09/27/2019, 5:35 PMdoest that exist for KDoc? 😛
r
Ruckus
09/27/2019, 5:35 PMKDoc uses markdown, so you should be able to use any HTML tags in there (again, unless I'm mistaken)
z
zkeme
09/27/2019, 5:35 PMzkeme
09/27/2019, 5:36 PMI haven't tried yet though
r
Ruckus
09/27/2019, 5:37 PMThe table shorthand syntax in that question is non-standard (I believe it's part of the GitHub markdown extensions). You should be able to use the HTML tags just fine.
z
zkeme
09/27/2019, 5:40 PMThis doesn't work on call site either 😞
zkeme
09/27/2019, 5:40 PMimage.png
zkeme
09/27/2019, 5:41 PMimage.png
zkeme
09/27/2019, 5:41 PMnothing about the table is shown
zkeme
09/27/2019, 5:41 PMoh well, its not like its a big deal 😛 I'll just lose the links
r
Ruckus
09/27/2019, 5:44 PMDang. I wonder why. Well, I guess you can vote for the issue https://youtrack.jetbrains.com/issue/KT-16228
Ruckus
09/27/2019, 5:46 PMI guess you're right. It does appear to be an IDE issue. The shorthand does get rendered properly by Dokka, just not in IDEA.
z
zkeme
09/27/2019, 6:13 PMYap.. oh well
zkeme
09/27/2019, 6:21 PMJust in case someone is reading this, in my case I can just use bullet points with
-zkeme
09/27/2019, 6:21 PMSince I don't really need a table, this is good enough for me
51 Views