ItzDerock / discord-markdown-parser

A library to parse discord style markdown into an abstract syntax tree.
Apache License 2.0
26 stars 10 forks source link
discord hacktoberfest markdown parse parser

discord-markdown-parser

Discord npm GitHub package.json version GitHub Repo stars

A node.js markdown implementation based on the simple-markdown library, which is the same technology discord use.

Designed to be used for discord-html-transcripts

discord-markdown-parser will parse any given string into an AST tree and supports:

Usage

import { parse } from 'discord-markdown-parser';
// or const { parse } = require('discord-markdown-parser');

// input is a string
const input = 'test **markdown** with `cool` *stuff*';

// specify what type of markdown this is
// this can be 'normal' or 'extended' (default = normal)
// extended should be used if the input is from a webhook message or embed description.
const type = 'normal';

// will return an AST tree
const parsed = parse(input, type);

Extending

// you can import the default rules using
import { rules } from 'discord-markdown-parser';

// and you can add your own rules
const newRules = {
    ...rules,
    customRule: {
        ...
    } // see simple-markdown documentation for details
};

// import simpleMarkdown
import SimpleMarkdown from 'simple-markdown';

// and create the parser
const parser = SimpleMarkdown.parserFor(newRules);