Next: , Previous: , Up: HTML export   [Contents][Index]


12.9.3 HTML doctypes

Org can export to various (X)HTML flavors.

Set the org-html-doctype variable for different (X)HTML variants. Depending on the variant, the HTML exporter adjusts the syntax of HTML conversion accordingly. Org includes the following ready-made variants:

See the variable org-html-doctype-alist for details. The default is “xhtml-strict”.

Org’s HTML exporter does not by default enable new block elements introduced with the HTML5 standard. To enable them, set org-html-html5-fancy to non-nil. Or use an OPTIONS line in the file to set html5-fancy. HTML5 documents can now have arbitrary #+BEGIN and #+END blocks. For example:

#+BEGIN_aside
Lorem ipsum
#+END_aside

Will export to:

<aside>
  <p>Lorem ipsum</p>
</aside>

While this:

#+ATTR_HTML: :controls controls :width 350
#+BEGIN_video
#+HTML: <source src="movie.mp4" type="video/mp4">
#+HTML: <source src="movie.ogg" type="video/ogg">
Your browser does not support the video tag.
#+END_video

Exports to:

<video controls="controls" width="350">
  <source src="movie.mp4" type="video/mp4">
  <source src="movie.ogg" type="video/ogg">
  <p>Your browser does not support the video tag.</p>
</video>

When special blocks do not have a corresponding HTML5 element, the HTML exporter reverts to standard translation (see org-html-html5-elements). For example, #+BEGIN_lederhosen exports to ‘<div class="lederhosen">’.

Special blocks cannot have headlines. For the HTML exporter to wrap the headline and its contents in ‘<section>’ or ‘<article>’ tags, set the HTML_CONTAINER property for the headline.


Next: , Previous: , Up: HTML export   [Contents][Index]