org: Images and tables

 
 11.2 Images and Tables
 ======================
 
 Both the native Org mode tables (SeeTables) and tables formatted
 with the ‘table.el’ package will be exported properly.  For Org mode
 tables, the lines before the first horizontal separator line will become
 table header lines.  You can use the following lines somewhere before
 the table to assign a caption and a label for cross references, and in
 Internal links::):
 
      #+CAPTION: This is the caption for the next table (or link)
      #+NAME:   tab:basic-data
         | ... | ...|
         |-----|----|
 
    Optionally, the caption can take the form:
      #+CAPTION[Caption for list of tables]: Caption for table.
 
    Some back-ends allow you to directly include images into the exported
 document.  Org does this, if a link to an image files does not have a
 description part, for example ‘[[./img/a.jpg]]’.  If you wish to define
 a caption for the image and maybe a label for internal cross references,
 make sure that the link is on a line by itself and precede it with
 ‘#+CAPTION’ and ‘#+NAME’ as follows:
 
      #+CAPTION: This is the caption for the next figure link (or table)
      #+NAME:   fig:SED-HR4049
      [[./img/a.jpg]]
 
 Such images can be displayed within the buffer.  Seethe discussion of
 image links Handling links.
 
    Even though images and tables are prominent examples of captioned
 structures, the same caption mechanism can apply to many others (e.g.,
 LaTeX equations, source code blocks).  Depending on the export back-end,
 those may or may not be handled.