Contents

### Include Markdown

Use file inclusion to include markdown.  The whole page, includer and includee, will be rendered when it's pushed to GitHub.

#### File to Be Included

Here's a file containing markdown to be included:

```markdown.md```:
```markdown
This fiie, to be included, is markdown.

### This is a level-three title.

Here's a [link](http://yahoo.com).

This is an unordered list:
* One.
* Two.
* Three.
```

#### Includer File

Here's a template file that includes it:

```includer.md```:
```markdown
This file includes the markdown file.

@[:markdown](markdown.md)
```

The treatment token ```:markdown``` specifies that the included text is to be treated as markdown.

#### Include Via <code>markdown_helper</code>
<details>
<summary>CLI</summary>

```sh
markdown_helper include --pristine includer.md included.md
```

(Option ```--pristine``` suppresses comment insertion.)
</details>
<details>
<summary>API</summary>

```include.rb```:
```ruby
require 'markdown_helper'

# Option :pristine suppresses comment insertion.
markdown_helper = MarkdownHelper.new(:pristine => true)
markdown_helper.include('includer.md', 'included.md')
```

</details>

#### File with Inclusion

Here's the finished file with the inclusion:

```included.md```:
```markdown
This file includes the markdown file.

This fiie, to be included, is markdown.

### This is a level-three title.

Here's a [link](http://yahoo.com).

This is an unordered list:
* One.
* Two.
* Three.
```

And here's the finished markdown, as rendered on this page:

---

This fiie, to be included, is markdown.

### This is a level-three title.

Here's a [link](http://yahoo.com).

This is an unordered list:
* One.
* Two.
* Three.

---

Version data entries

7 entries across 7 versions & 1 rubygems

Version	Path
markdown_helper-2.5.4	markdown/use_cases/include/include_markdown/use_case.md
markdown_helper-2.5.3	markdown/use_cases/include/include_markdown/use_case.md
markdown_helper-2.5.2	markdown/use_cases/include/include_markdown/use_case.md
markdown_helper-2.5.1	markdown/use_cases/include/include_markdown/use_case.md
markdown_helper-2.5.0	markdown/use_cases/include/include_markdown/use_case.md
markdown_helper-2.4.0	markdown/use_cases/include/include_markdown/use_case.md
markdown_helper-2.3.0	markdown/use_cases/include_files/include_markdown/use_case.md