What's so great about Docbook, any way? Glad you asked.
CommentsSubscribe to the comments RSS feed.
Comment #1 posted on 2017-09-13T02:36:01Z by Mike Ray
I completely agree that it is impossible to write anything complex in markdown without resorting to HTML tags.
For me it's putting anchor tags around headings to provide in-page links.
But you should take a look at kramdown. Debian install:
apt-get install ruby-kramdown
Has stuff that markdown doesn't, like tables, stuff like id and class attribs for css etc.
And auto-generation of tables-of-contents
Comment #2 posted on 2017-09-13T08:17:05Z by Florian
whats so hard about code in a list?
7 spaces makes sense, it's 3 for everything belonging to the same point on you list plus 4 for the code, see experiments on
(Yeah, "github-flavored" markdown, but it's a common dialect these days)
I still prefer three backticks, but I come from trac-wiki syntax via ReStructuredText to markdown and using single backticks for inline monospace but
in track still annoys me.
I understand the additional value semantic markup has but in many cases it's nice but not necessary.
-- sysadmin who never broke out into HTML in rst or markdown …
Comment #3 posted on 2017-09-15T10:33:15Z by Klaatu
Had not heard of kramdown. I'll take a look at it, for kicks, because it sounds pretty good.
Comment #4 posted on 2017-09-15T10:42:29Z by Klaatu
I have found that Guthub markdown is a heck of a lot better than markdown. In fact, it's so significantly better that I don't see why it's not merged into markdown yet, except that as far as I can tell markdown proper is unmaintained.
The existance of Github-markdown reinforces my point: markdown needed fixing.
But I agree; sometimes docbook is overkill and [github] markdown is a better choice. If I didn't say that in this or my previous episode, I did mean to, but maybe I was blinded by docbook passion.
Note to Verbose Commenters
If you can't fit everything you want to say in the comment below then you really should record a response show instead.
Note to Spammers
All comments are moderated. All links are checked by humans. We strip out all html. Feel free to record a show about yourself, or your industry, or any other topic we may find interesting. We also check shows for spam :).