Textual markup languages (was Re: What YAML engine do you use?)
alanmk at hotmail.com
Sun Jan 23 14:06:11 EST 2005
>> From what I've seen, pretty much every textual markup targetted
>> for web content, e.g. wiki markup, seems to have grown/evolved
>> organically, meaning that it is either underpowered or overpowered,
>> full of special cases, doesn't have a meaningful object model, etc.
> I spent the eighties designing one textual markup language after
> another, for a wide variety of projects (mainly for technical
> writing). I've since come to the conclusion that they all suck
> (for exactly the reasons you mention above, plus the usual
> "the implementation is the only complete spec we have" issue).
Thanks Fredrik, I thought you might have a fair amount of experience in
this area :-)
> the only markup language I've seen lately that isn't a complete mess
> is John Gruber's markdown:
> which has an underlying object model (HTML/XHTML) and doesn't have
> too many warts. not sure if anyone has done a Python implementation
> yet, though (for html->markdown, see
> http://www.aaronsw.com/2002/html2text/ ), and I don't think it
> supports footnotes (HTML doesn't).
Thanks for the pointer. I took a look at Markdown, and it does look
nice. But I don't like the dual syntax, e.g. switching into HTML for
tables, etc: I'm concerned that the syntax switch might be too much for
>> If I can't find such a markup language, then I might instead end up
>> using a WYSIWYG editing component that gives the user a GUI and
>> generates (x)html.
>> htmlArea: http://www.htmlarea.com/
>> Editlet: http://www.editlet.com/
>> But I'd prefer a markup solution.
> some of these are amazingly usable. have you asked your users what
> they prefer? (or maybe you are your user? ;-)
Actually, I'm looking for a solution for both myself and for end-users
(who will take what they're given ;-).
For myself, I think I'll end up picking Markdown, ReST, or something
comparable from the wiki-wiki-world.
For the end-users, I'm starting to think that GUI is the only way to go.
The last time I looked at this area, a few years ago, the components
were fairly immature and pretty buggy. But the number of such components
and their quality seems to have greatly increased in recent times.
Particularly, many of them seem to address an important requirement that
I neglected to mention in my original list: unicode support. I'll be
processing all kinds of funny characters, e.g. math/scientific symbols,
european, asian and middle-eastern names, etc.
email alan: http://xhaus.com/contact/alan
More information about the Python-list