var branch = require('metalsmith-branch')
 
metalsmith
  .use( branch()
          .pattern('*.md')        // for only md source files,
          .use( templates({       // run through swig template engine
                  engine: "swig",
                  inPlace: true
                })
          )
          .use( markdown() )      // and generate html
      )
 
// you can also specify the pattern directly in constructor
 
metalsmith
  .use( branch('images/*') 
          .use( imageVariants() )
      )
 
// or select files by function of their name, properties, and order:
 
var lastweek = function(filename,props,i){
  var dt = new Date()
    , last = new Date( dt.getFullYear(), dt.getMonth(), dt.getDate());
  last.setDate( last.getDate() - 6 )
  return ( props.published >= last );
}
 
metalsmith
  .use( branch( lastweek )
          .use( tagLatest() )
      )

// to post-process only markdown-sourced files in a 'special' dir:
 
metalsmith
  .use( branch('*.md')
          .use( markdown() )
          .use( branch('special/*.html')
                  .use( postProcess() )
              )
      )

// to select all markdown files in the "posts" and "projects" directories:
 
metalsmith
  .use( branch()
          .pattern(["projects/*/*.md", "posts/**/*.md"])
          .use( markdown() )
      )