import JavaScript from Markdown code blocks
Switch branches/tags
Nothing to show
Clone or download
vijithassar version bump
this is a breaking change, but we are pre-1.0
Latest commit e97c605 Dec 2, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
source require js or javascript language annotation after opening fence Dec 2, 2017
test test exclusion of code blocks that do not specify javascript Dec 2, 2017
.gitignore initial setup Nov 9, 2017
README.md documentation Dec 2, 2017
eslintrc.json add unit tests Nov 9, 2017
index.js add build stage Nov 10, 2017
package.json version bump Dec 2, 2017
rollup.config.js add build stage Nov 10, 2017

README.md

Overview

This Rollup plugin lets you extract your JavaScript code from code blocks embedded in Markdown files, which in turn promotes good written documentation. This technique is called literate programming.

For a more detailed discussion about why you might want to do this, or to implement with other programming languages and other JavaScript build tools, please instead see lit, a shell script which provides the same functionality in a more agnostic fashion.

Example

GitHub Flavored Markdown represents code using fenced code blocks, which are demarcated with three backticks in a row:

function greeting() {
    console.log('hello world');
}

export { greeting };

After you import and run this plugin in your rollup.config.js configuration file, the greeting() function above can be imported directly from this Markdown document! For example, you might use the following ES6 module import statement:

import { greeting } from './path/to/README.md';

Sourcemaps will correctly point your debugging back to the original Markdown documents.

You must include js or javascript as a language specifier after opening up a fenced code block in Markdown. Fenced code blocks that specify any other language and fenced code blocks that do not specify a language at all will be ignored. This makes it possible for you to include other code in your Markdown file without that code being executed. This is particularly useful for including Bash commands.