This is the official manual for the latest Org-mode release.

Table of Contents

Next: , Previous: Comment lines, Up: Exporting


12.7 ASCII/Latin-1/UTF-8 export

ASCII export produces an output file containing only plain ASCII characters. This is the most simplest and direct text output. It does not contain any Org markup either. Latin-1 and UTF-8 export use additional characters and symbols available in these encoding standards. All three of these export formats offer the most basic of text output for maximum portability.

On export, Org fills and justifies text according to the text width set in org-ascii-text-width.

Org exports links using a footnote-like style where the descriptive part is in the text and the link is in a note before the next heading. See the variable org-ascii-links-to-notes for details.

ASCII export commands

C-c C-e t a/l/u     (org-ascii-export-to-ascii)
Export as an ASCII file with a .txt extension. For myfile.org, Org exports to myfile.txt, overwriting without warning. For myfile.txt, Org exports to myfile.txt.txt in order to prevent data loss.
C-c C-e t A/L/U     (org-ascii-export-as-ascii)
Export to a temporary buffer. Does not create a file.

ASCII specific export settings

The ASCII export back-end has one extra keyword for customizing ASCII output. Setting this keyword works similar to the general options (see Export settings).

SUBTITLE
The document subtitle. For long subtitles, use multiple #+SUBTITLE lines in the Org file. Org prints them on one continuous line, wrapping into multiple lines if necessary.

Header and sectioning structure

Org converts the first three outline levels into headlines for ASCII export. The remaining levels are turned into lists. To change this cut-off point where levels become lists, see Export settings.

Quoting ASCII text

To insert text within the Org file by the ASCII back-end, use one the following constructs, inline, keyword, or export block:

     Inline text @@ascii:and additional text@@ within a paragraph.
     
     #+ASCII: Some text
     
     #+BEGIN_EXPORT ascii
     Org exports text in this block only when using ASCII back-end.
     #+END_EXPORT

ASCII specific attributes

ASCII back-end recognizes only one attribute, :width, which specifies the width of an horizontal rule in number of characters. The keyword and syntax for specifying widths is:

     #+ATTR_ASCII: :width 10
     -----

ASCII special blocks

Besides #+BEGIN_CENTER blocks (see Paragraphs), ASCII back-end has these two left and right justification blocks:

     #+BEGIN_JUSTIFYLEFT
     It's just a jump to the left...
     #+END_JUSTIFYLEFT
     
     #+BEGIN_JUSTIFYRIGHT
     ...and then a step to the right.
     #+END_JUSTIFYRIGHT