Markdown Tutorial contest feedback

6

The site now prompts users to recreate specific examples and displays notifications when they’ve successfully replicated the example. I’ve also updated the introductory tour to explain the role of the examples. If you’ve already completed the tour you’ll need to clear local storage for the site to see it again.

I can lock the lessons until the user completes the previous lessons. However, it does prevent casually referencing the examples. Is the goal to have a reference site or an end-to-end tutorial? I can make it work either way.

7

Thanks for the feedback. I’ve added lessons for escape characters, code spans, and code blocks. I’ve also updated the explanations for the lessons based on your feedback and tried to make distinctions about where CommonMark differs from other Markdown implementations. Please let me know if I missed the mark on any of these items.

8

Hi, I wrote this simple tutorial:

http://agea.github.io/tutorial.md

(it’s a static AngularJS app)

2 Likes
9

Great feedback! I’ll be reviewing entries next week and announce a winner either at the end of next week, or early the next.

There’s still time, so get your entries in! :wink:

10

I created a markdown tutorial: http://tylingsoft.github.io/tutorial.md/

The source code is here: https://github.com/tylingsoft/tutorial.md

The content of the tutorial is written in markdown: https://github.com/tylingsoft/tutorial.md/tree/gh-pages/wizard

Anybody can contribute to the code as long as he/she can write some markdown.

11

Excellent, I will be reviewing these this weekend.

12

Gathering links here as I begin the judging process.

by @jacobswain
http://www.markdown-tutorial.com/

by @agea
http://agea.github.io/tutorial.md

by @Tyler_Long
http://tylingsoft.github.io/tutorial.md/

By Sean Francis N. Ballais (via email)
http://seanballais.github.io/Marky/

By Joshua Gross (via email)
http://thisismarkdown.com/

By pkarthikr (via discourse.codinghorror)
http://pkarthik.in/learning-markdown
https://github.com/pkarthikr/learning-markdown

By eh3rrera (via discourse.codinghorror)
http://eh3rrera.github.io/markdowntutorial/

By JosephErnest (via discourse.codinghorror)
http://thisisvoid.org/markdown

1 Like
13

If I forgot any, please let me know. I pinged the folks that entered via email and on discourse.codinghorror as well.

14

so what happened, who won?

15

Still working on it :sweat_smile:

16

@codinghorror Do you want me to add the winning tutorial to the work in progress Middleman site over on my GitHub? The non-interactive guide I wrote is basically complete (minus a few sections). We should decide whether that’s still needed and then discuss how the interactive tutorial would best fit in with the rest of the site.

17

It’s been two months already. What happened?

1 Like
18

Sorry, life. Life happened. Three kids, parents with two jobs, a startup, a blog that needs updating (multiple blogs actually…)

Good news is, I have notes, and I have @jgm’s notes, so: soon!

Apologies for the delay.

1 Like
19

Winners have been selected!

First, thanks to everyone who participated – the entries were all of very high quality in my opinion!

First Prize :trophy:

The Markdown Tutorial by eh3rrera

all 16 books in my recommended reading list, or the Amazon value equivalent in a gift certificate ($440.74)

Second Prize :trophy:

http://www.markdown-tutorial.com/ by @jacobswain

a CODE Keyboard. This can be shipped worldwide.

Third Prize :trophy:

Tutorial.md by @agea

3 books of your choice from my recommended reading list, or the Amazon value equivalent in a gift certificate ($125.35)

Congratulations all! I’ll be contacting the winners to figure out where to send the prizes. And I’ll send our individual feedback to each entrant, as well.

7 Likes
20

Thanks @codinghorror and @jgm for selecting my tutorial as one of the winners and for your great and constructive feedback.

3 Likes
21

Congratulations @eh3rrera! Happy for you! I hope you have a good time with the books! :smile:
Can you spare a book? :wink: Haha. Just kidding. Good luck! May you write better code.

2 Likes
22

:smile: Thanks @seanballais

2 Likes
23

Is there any chance to see the tutorial in commonmark.org?

2 Likes
24

Yes, see http://commonmark.org/help :exclamation: