An open API service indexing awesome lists of open source software.

https://github.com/amdev9/markdown-it-wikicustom

Wiki custom style links for the markdown-it
https://github.com/amdev9/markdown-it-wikicustom

Last synced: about 10 hours ago
JSON representation

Wiki custom style links for the markdown-it

Awesome Lists containing this project

README

          

# Markdown-It Wiki Custom Links

Renders Wiki-like links in [markdown-it](https://github.com/markdown-it/markdown-it). This is useful for making Markdown-based wikis.

## Usage

Install this into your project:

```bash
npm --save install markdown-it-wikicustom
```

...and *use* it:

```js
const wikilinks = require('markdown-it-wikicustom')(options)
const md = require('markdown-it')()
.use(wikilinks)
.render('Click [[Wiki Links|here]] to learn about [[/Wiki]] links.')
```

**Output:**

```html

Click here to learn about Wiki links.


```

## Options

### `baseURL`

**Default:** ``

The base URL for absolute wiki links.

```js
const html = require('markdown-it')()
.use(require('markdown-it-wikicustom')({ baseURL: '/wiki/' }))
.render('[[Main Page]]')
//

Main Page


```

### `relativeBaseURL`

**Default:** ``

The base URL for relative wiki links.

```js
const html = require('markdown-it')()
.use(require('markdown-it-wikicustom')({ relativeBaseURL: '#', suffix: '' }))
.render('[[Main Page]]')
//

Main Page


```

### `makeAllLinksAbsolute`

**Default:** `false`

Render all wiki links as absolute links.

### `uriSuffix`

**Default:** ``

Append this suffix to every URL.

```js
const html = require('markdown-it')()
.use(require('markdown-it-wikicustom')({ uriSuffix: '.php', relativeBaseURL: './' }))
.render('[[Main Page]]')
//

Main Page


```

### `htmlAttributes`

**Default:** `{}`

An object containing HTML attributes to be applied to every link.

```js
const attrs = {
'class': 'wikilink',
'rel': 'nofollow'
}
const html = require('markdown-it')()
.use(require('markdown-it-wikicustom')({ htmlAttributes: attrs }))
.render('[[Main Page]]')
//

Main Page


```