md-code-stream

Extract code blocks from Markdown streams, so you can test them

Examples

In this example, we parse this README.md file and extract the first code block:

var fs = require('fs');
var assert = require('assert');
 
var mdCodeStream = require('md-code-stream');
 
var readme = fs.createReadStream('README.md')
               .pipe(mdCodeStream());
 
readme.once('entry', function(entry) {
  assert.equal(entry.section[0], 'md-code-stream');
  assert.equal(entry.section[1], 'Examples');
  assert.equal(entry.num, 0);
  assert.equal(entry.language, 'js');
  assert.equal(entry.props.path, 'md-code-stream/examples.js');
 
  // At this point we could also pipe it to stdout:
  // entry.pipe(process.stdout);
});

When given a filename as the first argument, the file will be opened and piped into the stream. The stream also collects all it's entries in the entries property:

var assert = require('assert');
var mdCodeStream = require('md-code-stream');
var readme = mdCodeStream('README.md');
 
readme.on('end', function() {
  assert.equal(readme.entries.length, 3);
});

The stream is compatible with fstream, so you can pipe it to a directory:

var fs = require('fs');
var fstream = require('fstream');
var assert = require('assert');
 
var mdCodeStream = require('md-code-stream');
 
fs.createReadStream('README.md')
  .pipe(mdCodeStream())
  .pipe(fstream.Writer({path: 'tmp', type: 'Directory'}))
  .on('close', function() {
    assert(fs.existsSync('tmp/md-code-stream/examples.js'));
    assert(fs.existsSync('tmp/md-code-stream/examples-1.js'));
    assert(fs.existsSync('tmp/md-code-stream/examples-2.js'));
  });