org: Include files
11.4 Include files
==================
During export, you can include the content of another file. For
example, to include your ‘.emacs’ file, you could use:
#+INCLUDE: "~/.emacs" src emacs-lisp
The optional second and third parameter are the markup (i.e., ‘example’
or ‘src’), and, if the markup is ‘src’, the language for formatting the
contents. The markup is optional; if it is not given, the text will be
assumed to be in Org mode format and will be processed normally.
Contents of the included file will belong to the same structure
(headline, item) containing the ‘INCLUDE’ keyword. In particular,
headlines within the file will become children of the current section.
That behavior can be changed by providing an additional keyword
parameter, ‘:minlevel’. In that case, all headlines in the included
file will be shifted so the one with the lowest level reaches that
specified level. For example, to make a file become a sibling of the
current top-level headline, use
#+INCLUDE: "~/my-book/chapter2.org" :minlevel 1
You can also include a portion of a file by specifying a lines range
using the ‘:lines’ parameter. The line at the upper end of the range
will not be included. The start and/or the end of the range may be
omitted to use the obvious defaults.
#+INCLUDE: "~/.emacs" :lines "5-10" Include lines 5 to 10, 10 excluded
#+INCLUDE: "~/.emacs" :lines "-10" Include lines 1 to 10, 10 excluded
#+INCLUDE: "~/.emacs" :lines "10-" Include lines from 10 to EOF
‘C-c '’
Visit the include file at point.