mkhtml.py: writing HTML documents in Markdown

[Kragen Javier Sitaker]

[I tried to send this before, but I guess I need to authorize
kragen at canonical.org to send to the list...]

On Sat, 7 Jun 2008 17:42:53 +0200, Aristotle Pagaltzis wrote:
> [Note to markdown-discuss readers: for context see
> <http://lists.canonical.org/pipermail/kragen-hacks/2008-June/000488.html>]
> 
> * Kragen Javier Sitaker <kragen at pobox.com> [2008-06-07 09:40]:
> > Stylesheeting comes naturally. I just put a `<style>` element
> > at the top with a few lines inside of it to format nicely.
> 
> Note that Markdown ends up wrapping `<link>` and `<style>`
> in `<p>` tags, arguably erroneously.

What, is Markdown supposed to know that those elements are neither
block-level nor span-level markup?

> Of course, neither tag has any business being in the HTML body;
> they should both be in the head. Since you’re loading
> BeautifulSoup anyway, you probably want to include that as fix-up
> step in your postprocessing.

Yeah, I've been planning to do that, but didn't get around to doing it
before sending it out.  (I also have this theory that I'll be a
happier person if I don't spend too much time on inventing private
markup languages, and that makes me perhaps unreasonably reluctant to
add extra postprocessing steps, even when the alternative is
ill-formed HTML.)

Kragen