Nonstandard markdown section links

DEVONthink
1

Devonthink section links for markdown aren’t following the standard used in other apps for multi word sections.
Given the following markdown document:

[devonthink link](#1.lisbonportugal)
[standard link](#1-lisbon-portugal)

### 1. Lisbon, Portugal

The first link works in Devonthink, either in the document, or as an external link (x-devonthink-item://6FD7BF60-CDD4-422E-ACD2-9068C8EBD6BA?section=1.lisbonportugal), but will not work in other apps.

The second links work in other markdown apps like Visual Studio Code and github, but do not work in Devonthink.

The other apps that I would say correctly handle markdown links, require that you remove all punctuation, convert to lowercase and replace spaces with hyphens.

Devonthink seems to require that you keep some punctuation (periods?), and requires spaces be removed.

Please support the more standard syntax for markdown section links.

2

Welcome @robboek

Devonthink section links for markdown aren’t following the standard used in other apps for multi word sections.

There isn’t a standard used in other applications. In fact, the lack of a standard is the issue, with many apps rolling their own flavors. This causes confusion and frustration when people try to use their Markdown files in a portable manner (which is one of the benefits of plain text formats).

That being said, we have long supported the generally accepted child of Gruber’s original syntax: MultiMarkdown.

The syntax for a cross-reference to a document’s section headers is: [Name of Header]. In your case, [1. Lisbon, Portugal], e.g.,…

1 Like