News for hackers. Stuff that matters.
Re:Don’t Use Markdown for Documentation by forsaken on Tuesday March 15, 2016 @05:55PM (#11293320)
Curious how you cross-referenced across the books? Did you do listings of API's?

Markdown is great for text content, not for formal documentation.

Re:Don’t Use Markdown for Documentation by _getify on Wednesday March 16, 2016 @12:42PM (#11298661)
The books were intended as source material for publishing, so I didn't embed any crosslinks in the documents.

However, I always use markdown for all my OSS project documentation (READMEs, etc), and I do lots and lots of cross-referencing in that context. I use simple markdown links to named-section anchors.

It's a tiny bit more manual than I'd like, but it's never stopped me from doing technical documentation effectively.