[OT] Markdown vs reStructuredText vs Textile vs Other

[AJ ONeal]

I've begun to hit the limitations of Markdown (I need to be able to do tables, for example).

I need a document language that

• Is intuitive, like markdown
• can be exported to HTML
• has a parser written in JavaScript
• can be parsed by github
• ability to export to PDF a plus

Any suggestions?

What other markdown languages (as opposed to markup languages) are the cool kids using?

I'm leaning towards reStructuredText as it seems to have a good following and I found some code that I can probably use

http://rst.ninjs.org/

AJ ONeal

[Matt]

What's wrong with using <table> tags in your markdown?

--
You received this message because you are subscribed to the Google Groups "nodejs" group.
To post to this group, send email to nod...@googlegroups.com.
To unsubscribe from this group, send email to nodejs+un...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/nodejs?hl=en.

[Gary Katsevman]

On Tue, Apr 5, 2011 at 21:48, Matt <hel...@gmail.com> wrote:
> What's wrong with using <table> tags in your markdown?

Yeah, I thought that markdown worked well with html, especially since
it is rendered as such.

------------------------
Gary Katsevman
Computer Science Undergraduate
Northeastern University
gkatsev.com

[AJ ONeal]

My purpose in using markdown languages is to have human-readable / machine-readable documentation.

html isn't human readable

<table>

<tr><td>a</td><td>b</td><td>c</td></tr>

<tr><td>1</td><td>2</td><td>3</td></tr>

</table>

markdown languages are

   a     b   c
|=====+====+====|
|  1  |  2 |  3 |
|-----+----+----|

AJ ONeal

[Aseem Kishore]

"Limitations of Markdown" you say? I'm not aware of such a thing! ;)

Check out PHP Markdown Extras, which extends Markdown with things like tables, and Maruku (Ruby), which extends PHP Markdown with even more, like PDF and LaTeX output:

http://michelf.com/projects/php-markdown/extra/

http://maruku.rubyforge.org/maruku.html

Sounds like this meets all your requirements! Now someone just needs to port these features to node.js... ;)

Cheers,

Aseem

--

[Aseem Kishore]

I spoke too soon -- you clearly stated that a JS parser is needed. Then as a community, let's expand our JS parsers to support these awesome extras!

(And fwiw, GitHub uses Maruku I believe. So if the JS parser isn't a strict requirement, your other req's are met.)

Aseem