Add resourceLink option

Author: wooorm

lib/handle/link.js

@@ -14,7 +14,7 @@ function link(node, _, context) {
   var value
   var stack
 
-  if (formatLinkAsAutolink(node)) {
+  if (formatLinkAsAutolink(node, context)) {
     // Hide the fact that we’re in phrasing, because escapes don’t work.
     stack = context.stack
     context.stack = []
@@ -65,6 +65,6 @@ function link(node, _, context) {
   return value
 }
 
-function linkPeek(node) {
-  return formatLinkAsAutolink(node) ? '<' : '['
+function linkPeek(node, _, context) {
+  return formatLinkAsAutolink(node, context) ? '<' : '['
 }

lib/util/format-code-as-indented.js

@@ -2,8 +2,8 @@ module.exports = formatCodeAsIndented
 
 function formatCodeAsIndented(node, context) {
   return (
-    node.value &&
     !context.options.fences &&
+    node.value &&
     // If there’s no info…
     !node.lang &&
     // And there’s a non-whitespace character…

lib/util/format-link-as-autolink.js

@@ -2,10 +2,11 @@ module.exports = formatLinkAsAutolink
 
 var toString = require('mdast-util-to-string')
 
-function formatLinkAsAutolink(node) {
+function formatLinkAsAutolink(node, context) {
   var raw = toString(node)
 
   return (
+    !context.options.resourceLink &&
     // If there’s a url…
     node.url &&
     // And there’s a no title…

readme.md

@@ -109,6 +109,11 @@ otherwise) (`'one'`, `'tab'`, or `'mixed'`, default: `'tab'`).
 
 Marker to use to serialize titles (`'"'` or `"'"`, default: `'"'`).
 
+###### `options.resourceLink`
+
+Whether to use reference links always (`boolean`, default: `false`).
+The default is to use autolinks (`<https://example.com>`) when possible.
+
 ###### `options.rule`
 
 Marker to use for thematic breaks (`'*'`, `'-'`, or `'_'`, default: `'*'`).

test.js

@@ -1459,6 +1459,19 @@ test('link', function (t) {
     'should use an autolink for nodes w/ a value similar to the url and a protocol'
   )
 
+  t.equal(
+    to(
+      {
+        type: 'link',
+        url: 'tel:123',
+        children: [{type: 'text', value: 'tel:123'}]
+      },
+      {resourceLink: true}
+    ),
+    '[tel:123](tel:123)\n',
+    'should use a resource link (`resourceLink: true`)'
+  )
+
   t.equal(
     to({
       type: 'link',

types/index.d.ts

@@ -64,6 +64,7 @@ declare namespace toMarkdown {
     incrementListMarker?: boolean
     listItemIndent?: 'tab' | 'one' | 'mixed'
     quote?: '"' | "'"
+    resourceLink?: boolean
     rule?: '-' | '_' | '*'
     ruleRepetition?: number
     ruleSpaces?: boolean