remark-wiki-link-plus

Parse and render wiki-style links in markdown especially Obsidian style links.

What is this ?

Using obsidian, when we type in wiki link syntax for eg. [[wiki_link]] it would parse them as anchors.

Features supported

• Support [[Internal link]]
• Support [[Internal link|With custom text]]
• Support [[Internal link#heading]]
• Support [[Internal link#heading|With custom text]]
• Support ![[Document.pdf]]
• Support ![[Image.png]]

• Supported image formats are jpg, jpeg, png, apng, webp, gif, svg, bmp, ico
• Unsupported image formats display a message for eg. ![[Image.xyz]] would render the following:
  Document type XYZ is not yet supported for transclusions

Future support:

• Support ![[Audio.mp3]]
• Support ![[Video.mp4]]
• Support ![[Embed note]]
• Support ![[Embed note#heading]]

Installation

1npm install remark-wiki-link-plus

Usage

1const unified = require('unified')
2const markdown = require('remark-parse')
3const wikiLinkPlugin = require('remark-wiki-link-plus');
4
5let processor = unified()
6    .use(markdown, { gfm: true })
7    .use(wikiLinkPlugin)

Configuration options

• options.markdownFolder [String]: A string that points to the content folder.

  The default hrefTemplate is:

1(permalink) => `/${permalink}`

Running the tests

1npm run test

Change Log

[1.1.1] - 2022-11-14

Fixed

• Permalinks not linking to case sensitive url paths
  • eg. before [[Page]] generates href="/page" but will now generate href="/Page"

[1.1.0] - 2022-09-06

Added

• Add support for more image formats
  • apng, webp, gif, svg, bmp, ico
• Add support for PDF documents
• Add warning for unsupported image formats

[1.0.2] - 2022-08-11

Added

• Add support for transclusion links / image links
• png, jpg, jpeg

[1.0.1] - 2022-08-04

Changed

• permalink for folders with an index file will tranform to folder name only. For example, if the wikilink is [[docs/index]] the href will be '/docs'.

Fixed

• broken links to filenames that matched the markdown folder name.