0.3.1 • Published 4 months ago

@pycord/discord-message-components-markdown v0.3.1

Weekly downloads
-
License
MIT
Repository
github
Last release
4 months ago

@pycord/discord-message-components-markdown

A markdown parser for Discord messages.

This is an adaption of discord-markdown by brussell98.

Using

yarn add @pycord/discord-message-components-markdown
npm i @pycord/discord-message-components-markdown

For browser use, import dist/markdown.min.js

const { parser, htmlOutput, toHTML } = require('@pycord/discord-message-components-markdown')

console.log(toHTML('This **is** a __test__'))
// => This <strong>is</strong> a <u>test</u>

Options

const { toHTML } = require('@pycord/discord-message-components-markdown')
toHTML('This **is** a __test__', options)

options is an object with the following properties (all are optional):

  • embed: Boolean (default: false), if it should parse embed contents (rules are slightly different)
  • escapeHTML: Boolean (default: true), if it should escape HTML
  • discordOnly: Boolean (default: false), if it should only parse the discord-specific stuff
  • discordCallback: Object, callbacks used for discord parsing. Each receive an object with different properties, and are expected to return an HTML escaped string
    • user: (id: Number) User mentions "@someperson"
    • channel: (id: Number) Channel mentions "#somechannel"
    • role: (id: Number) Role mentions "@somerole"
    • everyone: () Everyone mention "@everyone"
    • here: () Here mention "@here"
  • cssModuleNames: Object, maps CSS class names to CSS module class names

Mention and Emoji Handling

Using the discordCallback option you can define custom functions to handle parsing mention and emoji content. You can use these to turn IDs into names.

Example:

const { toHTML } = require('@pycord/discord-message-components-markdown')
toHTML('This is a mention for <@95286900801146880>', {
	discordCallback: {
		user: node => '@' + users[node.id],
	},
}) // -> This is a mention for @Brussell

Customizing

It is possible to change the rules used by this package. Take a look at the code to see how to create your own modified rule set.

0.3.1

4 months ago

0.3.0

4 months ago

0.2.1

4 months ago