"Include" extenal content

[blackfalcon]

It would be great if we could use a syntax like {{path/to/markdown.md}} to allow for reusable content, notes and code examples.

[AaronO]

@blackfalcon Yep, I saw that Rust by example (https://github.com/japaric/rust-by-example), has it's own preprocessor to do that.

I wonder if there are any plans in adding that to gfm, but it definitely makes sense when including larger pieces of code.

Also we need to decide how it should behave :
- A dump include of the contents
- Or including the contents of that file inside a code block

[show0k]

This issue can be closed ; as far as I know it is already included in gitbook.

You can do

{% include "./test.md" %}
{% include "git+https://github.com/GitbookIO/documentation.git/README.md#0.0.1" %}

[AaronO]

It is indeed. This was added with gitbook 1.0.0 if I recall correctly :)

[show0k]

This a little off topic question, but why don't you let include files from HTTP requests with a syntax like
{% include "https://raw.githubusercontent.com/GitbookIO/documentation/master/README.md" %}
?
If the git repo is fat, it can be very slow to import the file. And by the way, if you find interesting to use a VCS, SVN allow to pull file by file, it is convenient to use it on GitHub repo for fetching a file.