This is the official manual for the latest Org-mode release.
It is possible to export the code of code blocks, the results
of code block evaluation, both the code and the results of code block
evaluation, or none. For most languages, the default exports code.
However, for some languages (e.g.,
ditaa) the default exports the
results of code block evaluation. For information on exporting code block
bodies, see Literal examples. For information on exporting
parts of Org documents, see Exporting.
:exports header argument can be used to specify export
behavior (note that these arguments are only relevant for code blocks, not
It is possible to inhibit the evaluation of code blocks during export.
org-export-babel-evaluate variable to
ensure that no code blocks are evaluated as part of the export process. This
can be useful in situations where potentially untrusted Org mode files are
exported in an automated fashion, for example when Org mode is used as the
markup language for a wiki. It is also possible to set this variable to
inline-only. In that case, only inline code blocks will be
evaluated, in order to insert their results. Non-inline code blocks are
assumed to have their results already inserted in the buffer by manual
evaluation. This setting is useful to avoid expensive recalculations during
export, not to provide security.
Code blocks in commented subtrees (see Comment lines) are never evaluated on export. However, code blocks in subtrees excluded from export (see Export settings) may be evaluated on export.