unified

Project: syntax-tree/unist-util-source

Package: unist-util-source@4.0.1

  1. Dependencies: 0·Dependents: 10
  2. unist utility to get the source of a value
  1. util 128
  2. utility 124
  3. unist 120
  4. unist-util 25
  5. node 23
  6. position 9
  7. source 3

unist-util-source

Build Coverage Downloads Size Sponsors Backers Chat

unist utility to get the source of a node or at a position.

Install

This package is ESM only: Node 12+ is needed to use it and it must be imported instead of required.

npm:

npm install unist-util-source

Use

Say we have the following file, example.md:

> + **[Hello](./example)**
>   world.

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

import {toVFile} from 'to-vfile'
import unified from 'unified'
import remarkParse from 'remark-parse'
import {source} from 'unist-util-source'

var file = toVFile.readSync('example.md')
var tree = unified()
  .use(remarkParse)
  .parse(file)

var strong = tree.children[0].children[0].children[0].children[0].children[0]
console.log(source(strong, file))

Now, running node example yields:

**[Hello](./example)**

API

source(value, file)

This package exports the following identifiers: source. There is no default export.

Parameters
Returns

string? — Source of value in doc, if available.

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, organisation, or community you agree to abide by its terms.

License

MIT © Titus Wormer