Contents

# MarkdownHelper

## File Inclusion  <img src="/images/include.png" width="50">

This markdown helper enables file inclusion in GitHub markdown.

(Actually this README file is built using the file inclusion.)

You can use it to merge external files into a markdown (```.md```) file.

The merged text can be highlighted in a code block:

@[ruby](include.rb)

or plain in a code block:

@[:code_block](include.rb)

or verbatim (which GitHub renders however it likes).

## Usage

### Including Files in Markdown

@[verbatim](include.md)

Each inclusion line has:

* A leading ```@``` character.
* A *treatment* in square brackets, one of:
  * Highlighting mode such as ```[ruby]```, to include a highlighted code block.  This can be any Ace mode mentioned in [GitHub Languages](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml).
  * ```[:code_block]```, to include a plain code block.
  * ```[:verbatim]```, to include text verbatim (to be rendered as markdown).
* A relative file path in parentheses, pointing to the file to be included.

### Including the Files

@[ruby](usage.rb)

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
markdown_helper-0.1.0	readme/README.template.md