News for hackers. Stuff that matters.
Re:Don’t Use Markdown for Documentation by chipsy on Tuesday March 15, 2016 @05:06PM (#11293000)
When I was confronted with this dilemma for the first time I attacked it by using multiple passes. My original draft is markdown. I pandoc it to DocBook. Then I add frills and edits in DocBook.

I see the process as not being different from what's needed to do the writing - compiling notes and sketches and outlines into a coherent narrative.

Re:Don’t Use Markdown for Documentation by vq on Tuesday March 15, 2016 @05:35PM (#11293201)
I have a very similar process. I start of with an org document, do a couple of drafts and then pandoc to LaTeX, pull in the proper template and add the frills as you say.