markdown url tag fails when line is indented

[falkben]

Attempting to use a url tag in markdown doesn't actually render the URL or static file into HTML, it just displays whatever was entered, including the url tag. Am I missing something?

[url('/content/pages/archive.md') ]

https://github.com/grow/grow.io/blob/master/content/docs/markdown-extensions.md#url

[Zoramite]

You need to take out the extra space at the end: [url('/content/pages/archive.md')]

The docs mention this: # Remove the extra space after ).

Sorry for the trouble, but it parses it if the space isn't there, then it can't show the example in the docs.

[falkben]

Sorry, I copied directly from that help file, but in my code, I actually did take out the space. You can confirm it's working (without the space)?

[Zoramite]

Here is an example:

On the docs page for templates, the docs are using the url tag.

See the [full documentation for the document API]([url('/content/docs/documents.md')]).

[falkben]

It seems as though I just had my parenthesis and square brackets wrong. Thanks for the help!

[falkben]

ah, I see the issue why it wasn't working -- indenting within the markdown file breaks the url tag from being processed

[Zoramite]

Currently we don't do it when the line is indented because we can't easily tell if the line is in a code block or not (since code blocks in markdown are indented lines.

I'm not sure if we will be able to really fix it and allow it to be ignored in code blocks... but maybe that doesn't really matter if it parsed in code blocks.

[falkben]

Yea, I'm not sure how to disambiguate a code block versus indent. The python markdown library supposedly implements it as indents though, which is why I was confused it wasn't working as expected:

The syntax rules clearly state that when a list item consists of multiple paragraphs, “each subsequent paragraph in a list item must be indented by either 4 spaces or one tab” (emphasis added). However, many implementations do not enforce this rule and allow less than 4 spaces of indentation. The implementers of Python-Markdown consider it a bug to not enforce this rule.

This applies to any block level elements nested in a list, including paragraphs, sub-lists, blockquotes, code blocks, etc. They must always be indented by at least four spaces (or one tab) for each level of nesting.

In the event that one would prefer different behavior, tab_length can be set to whatever length is desired. Be warned however, as this will affect indentation for all aspects of the syntax (including root level code blocks).

-- https://python-markdown.github.io/#differences