Add chapter in readme about conrefs

1 files changed, 26 insertions, 0 deletions

diff --git a/README.md b/README.md
index cf4b9b2..9b600cc 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,8 @@ $ gitbook build ./repository ./outputFolder
 * [Glossary](#glossary)
 * [Cover](#cover)
 * [AsciiDoc Support](#asciidoc)
+* [Variables and Templating](#variables-and-templating)
+* [Content References](#content-references)
 * [Plugins](#plugins)
 
 ## Output Formats
@@ -109,6 +111,30 @@ Definition for this term
 With it's definition, this can contain bold text and all other kinds of inline markup ...
 ```
 
+#### Variables and Templating
+
+#### Content References
+
+You can use "content references," or conrefs, when writing books or documentation using GitBook.
+
+Include a file from the same book:
+
+```
+{% include "./test.md" %}
+```
+
+or from a git repository (with a specific revision):
+
+```
+{% include "git+https://github.com/GitbookIO/documentation.git/README.md#1.0.1" %}
+```
+
+Includes can be used with variables (see [Variables and Templating](#variables-and-templating)):
+
+```
+{% include book.ref_doc_readme %}
+```
+
 #### Ignoring files & folders
 
 GitBook will read the `.gitignore`, `.bookignore` and `.ignore` files to get a list of files and folders to skip. (The format inside those files follows the same convention as `.gitignore`).