To install this package, run in Emacs:
M-x package-install RET htmlize RET
This package converts the buffer text and the associated decorations to HTML. Mail to <firstname.lastname@example.org> to discuss features and additions. All suggestions are more than welcome. To use it, just switch to the buffer you want HTML-ized and type `M-x htmlize-buffer'. You will be switched to a new buffer that contains the resulting HTML code. You can edit and inspect this buffer, or you can just save it with C-x C-w. `M-x htmlize-file' will find a file, fontify it, and save the HTML version in FILE.html, without any additional intervention. `M-x htmlize-many-files' allows you to htmlize any number of files in the same manner. `M-x htmlize-many-files-dired' does the same for files marked in a dired buffer. htmlize supports three types of HTML output, selected by setting `htmlize-output-type': `css', `inline-css', and `font'. In `css' mode, htmlize uses cascading style sheets to specify colors; it generates classes that correspond to Emacs faces and uses <span class=FACE>...</span> to color parts of text. In this mode, the produced HTML is valid under the 4.01 strict DTD, as confirmed by the W3C validator. `inline-css' is like `css', except the CSS is put directly in the STYLE attribute of the SPAN element, making it possible to paste the generated HTML into existing HTML documents. In `font' mode, htmlize uses <font color="...">...</font> to colorize HTML, which is not standard-compliant, but works better in older browsers. `css' mode is the default. You can also use htmlize from your Emacs Lisp code. When called non-interactively, `htmlize-buffer' and `htmlize-region' will return the resulting HTML buffer, but will not change current buffer or move the point. htmlize will do its best to work on non-windowing Emacs sessions but the result will be limited to colors supported by the terminal. htmlize aims for compatibility with older Emacs versions. Please let me know if it doesn't work on the version of GNU Emacs that you are using. The package relies on the presence of CL extensions; please don't try to remove that dependency. I see no practical problems with using the full power of the CL extensions, except that one might learn to like them too much. The latest version is available at: <https://github.com/hniksic/emacs-htmlize> <https://code.orgmode.org/mirrors/emacs-htmlize> Thanks go to the many people who have sent reports and contributed comments, suggestions, and fixes. They include Ron Gut, Bob Weiner, Toni Drabik, Peter Breton, Ville Skytta, Thomas Vogels, Juri Linkov, Maciek Pasternacki, and many others. User quotes: "You sir, are a sick, sick, _sick_ person. :)" -- Bill Perry, author of Emacs/W3
htmlize NEWS -- history of user-visible changes. * Changes in htmlize 1.51 ** `htmlize-face-overrides' can be used to override Emacs's face definitions. * Changes in htmlize 1.47 ** GNU Emacs 21 is no longer supported. * Changes in htmlize 1.45 ** Correctly handle :inherit specifying a list of faces. (This bug would cause an error in AUX TeX buffers.) * Changes in htmlize 1.44 ** Faces specified in the `face' property are now prioritized the same way that Emacs redisplay does it: faces that appear earlier have precedence over those that appear later. * Changes in htmlize 1.41 ** `before-string' and `after-string' overlay properties are now recognized by htmlize and inserted into the HTML. ** Images specified by `display' property are recognized and inserted into the HTML as <img src=...>. *** If the image data comes from a file, the image will be rendered as a relative URI that would resolve to that file. Images whose data comes from a string will be rendered inline as data: URIs. The flag `htmlize-force-inline-images' can be used to force inserting *all* images inline as data: URIs. ** The image's ALT text will be the text that the `display' property is replacing, if non-empty. ** Arbitrary links can now be added to the generated HTML. If htmlize encounters buffer text with `htmlize-link' property, it will wrap the text in <a href="uri">...</a>. If the property value is a string, it is interpreted as the URI. If it is a list, it should be a property list whose currently only defined key is :uri.