jscreole

A JavaScript library for parsing Creole 1.0 wiki markup. This is a modernized fork with TypeScript support and both DOM and HTML string output.

Installation

npm install jscreole

Usage

HTML String Output

import { toHtml } from 'jscreole';

const html = toHtml('**bold** and //italic//');
// => '<p><strong>bold</strong> and <em>italic</em></p>'

DOM Output (Browser)

import { creole } from 'jscreole';

const parser = new creole({
  linkFormat: '/wiki/',
  interwiki: {
    Wikipedia: 'https://en.wikipedia.org/wiki/'
  }
});

const container = document.createElement('div');
parser.parse(container, '[[Wikipedia:JavaScript]]');
// container.innerHTML => '<p><a href="https://en.wikipedia.org/wiki/JavaScript">Wikipedia:JavaScript</a></p>'

Node.js with jsdom

const { creole } = require('jscreole');
const { JSDOM } = require('jsdom');

const dom = new JSDOM();
const parser = new creole();
const container = dom.window.document.createElement('div');
parser.parse(container, '* list item');

Options

Option	Type	Default	Description
strict	boolean	false	Strict Creole 1.0 mode (e.g., requires image alt text)
linkFormat	string | [string, string?] | function	-	Format for internal wiki links
interwiki	Record<string, LinkFormat>	-	Interwiki link mappings
defaultImageText	string	''	Default alt text for images without alt text
maxInputLength	number	102400	Maximum input length (100KB default, ReDoS protection)

Link Formats

Link formats can be:

• A string prefix: '/wiki/' → /wiki/MyPage
• An array with prefix and suffix: ['/pages/', '/view'] → /pages/MyPage/view
• A function: (link) => '/page/' + link.toLowerCase()

API

toHtml(wikiText: string, options?: CreoleOptions): string

Parse Creole markup and return HTML string. Use this for server-side rendering or when you don't need DOM manipulation.

new creole(options?: CreoleOptions)

Create a new parser instance.

parser.parse(container: Element, wikiText: string, options?: CreoleOptions): void

Parse Creole markup and append the result to the container element.

Security

The parser includes ReDoS protection via an input length guard (default 100KB). You can adjust this with the maxInputLength option.

License

MIT License. Original implementation by Ivan Fomichev, with portions by Chris Purcell.

Creole 1.0 Support

This parser implements the full Creole 1.0 specification. See http://www.wikicreole.org/wiki/Creole1.0 for details.