mdast-util-from-markdown

WebJar for mdast-util-from-markdown

License	MIT
GroupId	org.webjars.npm
ArtifactId	mdast-util-from-markdown
Last Version	0.8.5
Release Date	Apr 16, 2021
Type	jar
Description	mdast-util-from-markdown WebJar for mdast-util-from-markdown
Project URL	https://www.webjars.org
Source Code Management	https://github.com/syntax-tree/mdast-util-from-markdown

Download mdast-util-from-markdown

Filename	Size
mdast-util-from-markdown-0.8.5.pom
mdast-util-from-markdown-0.8.5.jar	16 KB
mdast-util-from-markdown-0.8.5-sources.jar	22 bytes
mdast-util-from-markdown-0.8.5-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/mdast-util-from-markdown/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>mdast-util-from-markdown</artifactId>
    <version>0.8.5</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/mdast-util-from-markdown/
implementation 'org.webjars.npm:mdast-util-from-markdown:0.8.5'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/mdast-util-from-markdown/
implementation ("org.webjars.npm:mdast-util-from-markdown:0.8.5")

Apache Buildr

'org.webjars.npm:mdast-util-from-markdown:jar:0.8.5'

Apache Ivy

<dependency org="org.webjars.npm" name="mdast-util-from-markdown" rev="0.8.5">
  <artifact name="mdast-util-from-markdown" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='mdast-util-from-markdown', version='0.8.5')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "mdast-util-from-markdown" % "0.8.5"

Leiningen

[org.webjars.npm/mdast-util-from-markdown "0.8.5"]

Dependencies

compile (5)

Group / Artifact	Type	Version
org.webjars.npm : parse-entities	jar	[2.0.0,3)
org.webjars.npm : types__mdast	jar	[3.0.0,4)
org.webjars.npm : unist-util-stringify-position	jar	[2.0.0,3)
org.webjars.npm : micromark	jar	[2.11.0,2.12)
org.webjars.npm : mdast-util-to-string	jar	[2.0.0,3)

Project Modules

There are no modules declared in this project.

mdast-util-from-markdown

mdast utility to parse markdown.

Install

npm:

npm install mdast-util-from-markdown

Use

Say we have the following markdown file, example.md:

## Hello, *World*!

And our script, example.js, looks as follows:

var fs = require('fs')
var fromMarkdown = require('mdast-util-from-markdown')

var doc = fs.readFileSync('example.md')

var tree = fromMarkdown(doc)

console.log(tree)

Now, running node example yields (positional info removed for brevity):

{
  type: 'root',
  children: [
    {
      type: 'heading',
      depth: 2,
      children: [
        {type: 'text', value: 'Hello, '},
        {
          type: 'emphasis',
          children: [{type: 'text', value: 'World'}]
        },
        {type: 'text', value: '!'}
      ]
    }
  ]
}

API

fromMarkdown(doc[, encoding][, options])

Parse markdown to a mdast tree.

Parameters

doc

Value to parse (string or Buffer).

encoding

Character encoding to understand doc as when it’s a Buffer (string, default: 'utf8').

options.extensions

Array of syntax extensions (Array.<MicromarkSyntaxExtension>, default: []). Passed to micromark as extensions.

options.mdastExtensions

Array of mdast extensions (Array.<MdastExtension>, default: []).

Returns

Root.

List of extensions

• syntax-tree/mdast-util-directive — parse directives
• syntax-tree/mdast-util-footnote — parse footnotes
• syntax-tree/mdast-util-frontmatter — parse frontmatter (YAML, TOML, more)
• syntax-tree/mdast-util-gfm — parse GFM
• syntax-tree/mdast-util-gfm-autolink-literal — parse GFM autolink literals
• syntax-tree/mdast-util-gfm-strikethrough — parse GFM strikethrough
• syntax-tree/mdast-util-gfm-table — parse GFM tables
• syntax-tree/mdast-util-gfm-task-list-item — parse GFM task list items
• syntax-tree/mdast-util-math — parse math
• syntax-tree/mdast-util-mdx — parse MDX or MDX.js
• syntax-tree/mdast-util-mdx-expression — parse MDX or MDX.js expressions
• syntax-tree/mdast-util-mdx-jsx — parse MDX or MDX.js JSX
• syntax-tree/mdast-util-mdxjs-esm — parse MDX.js ESM

Security

As Markdown is sometimes used for HTML, and improper use of HTML can open you up to a cross-site scripting (XSS) attack, use of mdast-util-from-markdown can also be unsafe. When going to HTML, use this utility in combination with hast-util-sanitize to make the tree safe.

Related

• micromark/micromark — the smallest commonmark-compliant markdown parser that exists
• remarkjs/remark — markdown processor powered by plugins
• syntax-tree/mdast-util-to-markdown — serialize mdast to markdown

Contribute

See contributing.md in syntax-tree/.github for ways to get started. See support.md for ways to get help.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.

License

MIT © Titus Wormer

🌲🌲🌲🌳🌲🌳🌲🌲🌲🌳🌳🌲🌲🌳🌲🌲🎄🌲🌳🌲🌲🌳🐻🌳🌳🌳🌲🌲🌳🌲🎄🌲🌳🌲🌲🌳🌳🌳

Versions

Version
0.8.5 Apr 16, 2021
0.8.4 Feb 2, 2021