Markdown and links

(Nick) #1

The Add Link menu option doesn’t appear to be working in markdown. Does anyone know a workaround?

Specifically, clicking on “Add Link” on markdown text brings up the add link dialogue as expected. The link appears in underlined blue in the markdown editor. But the link is not carried through to the actual HTML. (I find this by inspecting the code in the generated HTML page.)

So far, my workaround is to put the link in manually as markdown code. This is fine for external links. But for internal links (other pages in the project), it is a bit of a pain since it involves figuring out exactly the correct folder and file name for the linked page.

Am I missing something? Thanks!

(Mathew Mitchell) #2

I believe the add link button only works with styled text. The markdown stack is expecting you to do all related stuff in … markdown. With markdown you always need to provide an exact URL: not really any different for external vs. internal pages. Yes, perhaps it’s a wee bit more inconvenient but only a little. The advantages of markdown way way outweigh this minor disadvantage.

… or just switch back to styled text if it’s a big issue for you.

(Nick) #3

Thanks for replying, Mathew.

To be more clear, there is a bug, since the Add Link dialogue purportedly adds a link, but the link isn’t actually there. So at a minimum, Add Link should be disabled for markdown.

Better yet would be if the Add Link dialogue were smart enough to generate the necessary markdown to insert the link. I doubt this would be hard, and would remove tedious work in authoring markdown pages.

(Robert Ziebol 🖖🏼) #4

What version of RapidWeaver/Stacks Plugin are you using? I do not see the link buttons working in the Markdown stack at all.

(Nick) #5

Version 6.3.8 (15165) of RapidWeaver, and v3.0.0 of Stacks. I just tried updating, and it reported that this is the latest version.

I select text, right-click on the selected text, and select “Add Link” from the menu.

(Mathew Mitchell) #6

Okay, well I see how you are activating links. This should definitely be fixed by RealMac by disabling this “feature” for Markdown stacks. Actually I don’t know if this needs to be fixed by RealMac (@dan ) or by YourHead (@isaiah ). But it is definitely misleading.

(Robert Ziebol 🖖🏼) #7

Go to Yourhead to get the latest version of Stacks
Just download it and install, you must have a beta or something that is not seeing the latest

(Nick) #8

Thanks Zeebe! I’m now at 3.0.5, and the behaviour is unchanged.

(Robert Ziebol 🖖🏼) #9

I wouldn’t expect the link thing to work in Markdown anyways, links in markdown should be like this:
which will give you this

(Nick) #10

Yes, of course. My issue is that either (1) the add link menu should be removed for markdown, or (2) it should do something useful like adding the markdown equivalent for the selected link.

(Tapio Laakkonen) #11

I am glad that I fond this thread!

Guys like me who don’t have previous experience or the web design or coding background these issues can give a head scratch for few days.

Well, it seems that left click linking option is still available with Mark Down page. I guess for many, like me Mark Down page wasn’t the first option but due changing project stacks along the way I changed Text stack to Mark Down, and end up re-linking and re-publishing again and again needlessly.

Bottom line newbies: Internal page linking with Mark Down stack does not work. Use Text stack.

(Nick) #12

I’ve been trialling Bear recently, and realize that it’s exactly what I wish Markdown in RapidWeaver could be.

Not sure if this is for @dan or @isaiah, but I’d love, love, love it if you could do something for us Markdown users.

(Mathew Mitchell) #13

??? Not sure what you mean. Did you use the Markdown specific code for links? That will work for regular external links or internal links. But, yes, linking works differently because it is a markdown stack all the way. (Just like select/link won’t work with HTML stacks.)

(Michael Frankland) #14

I believe RapidWeaver has all the usual Markdown syntax possible (for example from the cheatsheet:

It’s also possible to write full Markdown in Pulse:

(with examples)

(Nick) #15

All true, @yuzool - you can type in any raw Markdown into the Markdown stack.

But in the meantime, a number of Markdown editors have been showing up that provide beautiful support for editing markdown. Bear and Ulysses are two obvious examples. For example, with Bear linking to pictures and other pages is done with drag-and-drop, and the corresponding Markdown code is automatically inserted into your document. Auto-formatting is provided so the document doesn’t look like a wall of plain text.

Basically, RapidWeaver is providing Markdown users with a plain text editor, not a real Markdown editor.