jgm / djot

A light markup language
https://djot.net
MIT License
1.62k stars 43 forks source link

Playground should provide examples #260

Open 2-anna opened 7 months ago

2-anna commented 7 months ago

This looks like a very promising project but it's hard to get a quick feeling for it, the website only provides links to its syntax reference and no examples. This is more effort that a new potential user might be willing to invest.

At least the playground (ideally also website) should provide examples that showcase its features. Maybe 2 headings, one for the parts that are the same as markdown and one for the parts that are different. Each with a paragraph or two of artificial text using as many features as reasonabley fits.

Show that the basics are just as comfortable as markdown and that it provides additional value in a way that that takes less than a minute to read.