consumer-centric-api-design icon indicating copy to clipboard operation
consumer-centric-api-design copied to clipboard

Should the book be in Markdown? Is LaTeX too scary?

Open tlhunter opened this issue 11 years ago • 3 comments

It might be beneficial to convert the content of the book to Markdown, then implement some sort of Markdown to LaTeX converter, allowing people to write content in a familiar language.

The only problem is the book loses it's awesome formatting and inter-content hyperlinking.

tlhunter avatar Aug 09 '14 23:08 tlhunter

You might consider reStructuredText as a sort of middle ground. It's more familiar and "Markdownish" than LaTeX, but would allow you to keep the inter-content hyperlinking and formatting as well.

rshipp avatar Aug 12 '14 17:08 rshipp

If you use reStructuredText and Sphinx you can get very high-quality nice looking output, both in HTML and PDF. I'm using it for documenting my projects.

mmontone avatar Aug 14 '14 01:08 mmontone

Hi, I'm reading your book to get some feel about how to design my first restful api and I found it really helps and awesome.

For markdown, I think it is really a better choice over LaTeX. and I recommend pandoc(http://johnmacfarlane.net/pandoc/) for you. Pandoc is really awesome and it converts everything to anything.

If you want to do this convert, I can provide some help, I'm sure I'm an expert in this field.

xiaohanyu avatar Nov 22 '14 07:11 xiaohanyu