{"action":"created","issue":{"url":"https://api.github.com/repos/lotabout/ideas/issues/7","repository_url":"https://api.github.com/repos/lotabout/ideas","labels_url":"https://api.github.com/repos/lotabout/ideas/issues/7/labels{/name}","comments_url":"https://api.github.com/repos/lotabout/ideas/issues/7/comments","events_url":"https://api.github.com/repos/lotabout/ideas/issues/7/events","html_url":"https://github.com/lotabout/ideas/issues/7","id":135377182,"number":7,"title":"write a markdown parser","user":{"login":"lotabout","id":1527040,"avatar_url":"https://avatars.githubusercontent.com/u/1527040?v=3","gravatar_id":"","url":"https://api.github.com/users/lotabout","html_url":"https://github.com/lotabout","followers_url":"https://api.github.com/users/lotabout/followers","following_url":"https://api.github.com/users/lotabout/following{/other_user}","gists_url":"https://api.github.com/users/lotabout/gists{/gist_id}","starred_url":"https://api.github.com/users/lotabout/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lotabout/subscriptions","organizations_url":"https://api.github.com/users/lotabout/orgs","repos_url":"https://api.github.com/users/lotabout/repos","events_url":"https://api.github.com/users/lotabout/events{/privacy}","received_events_url":"https://api.github.com/users/lotabout/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-02-22T10:26:30Z","updated_at":"2016-02-28T02:48:40Z","closed_at":null,"body":"Well, this is a also a MUST DO item for me. But I am always fail to really start the project. I've read quite a lot of article about it and cannot find a tutorial. Which is actually not necessary.\r\n\r\nWell, the above are just some complains about myself. I should finish it in the end.\r\n\r\n## Resources\r\n\r\n- [Common Mark](http://commonmark.org/) -- a markdown that tries to standardize markdown's syntax "},"comment":{"url":"https://api.github.com/repos/lotabout/ideas/issues/comments/189767688","html_url":"https://github.com/lotabout/ideas/issues/7#issuecomment-189767688","issue_url":"https://api.github.com/repos/lotabout/ideas/issues/7","id":189767688,"user":{"login":"lotabout","id":1527040,"avatar_url":"https://avatars.githubusercontent.com/u/1527040?v=3","gravatar_id":"","url":"https://api.github.com/users/lotabout","html_url":"https://github.com/lotabout","followers_url":"https://api.github.com/users/lotabout/followers","following_url":"https://api.github.com/users/lotabout/following{/other_user}","gists_url":"https://api.github.com/users/lotabout/gists{/gist_id}","starred_url":"https://api.github.com/users/lotabout/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lotabout/subscriptions","organizations_url":"https://api.github.com/users/lotabout/orgs","repos_url":"https://api.github.com/users/lotabout/repos","events_url":"https://api.github.com/users/lotabout/events{/privacy}","received_events_url":"https://api.github.com/users/lotabout/received_events","type":"User","site_admin":false},"created_at":"2016-02-28T02:48:40Z","updated_at":"2016-02-28T02:48:40Z","body":"Well, after so many effort of researching, I feel that the most difficult part of implementing a markdown is what to implement! There are so many variants of markdown, they all add their own features and they are useful in real cases of writing.\r\n\r\n## Why there are so many variants of Markdown\r\n\r\nSo my conclusion is:\r\n\r\n1. Markdown is popular because its simplicity.\r\n2. The simplicity causes the lack of features, and that why there are so many variants around.\r\n3. By adding so many features, markdown would no longer be simple and that makes it no longer markdown.\r\n\r\nI've loved markdown the first time I use it. What I love most about it is that it is human readable even before the conversion. I've used reStructuredText, as a whole it is more expressive than markdown for allowing a lot of features, but I think that is why others don't like it, too complex.\r\n\r\n## What Markdown should be like\r\n\r\nThe first time that I heard John Gruber(The original author of markdown) is against commonMark which trys to standardize markdown I was confused. But now I an somehow with him.\r\n\r\n**Markdown should be simple, intuitive and out of box**\r\n\r\nCommonMark did a great job of specify a lot of corner cases and how we should deal with it. But somehow it make things not so intuitive any more. For example, lists in commonmark should be indented, for example\r\n\r\n```\r\n1. ---\r\n    code here\r\n    ---\r\n```\r\nHowever in real case, we might past some code, and result in no indentation:\r\n\r\n```\r\n1. ---\r\ncode here\r\n---\r\n```\r\n\r\ncommonMark will not treat it as code any more.\r\n\r\n## What should we developer do?\r\n\r\nThere are so many corner case of usage that Markdown is unable to and should not cover. Then how should developer choose which to implement?\r\n\r\nWe all like perfect things, but that is not how the world work. 8/2 rule may suggest that 20% of current features will suite 80% of use case. Take GFM(Github Flavored Markdown) as an example. It is definitely not as conscious and powerful as commonMark(at least I think so), but for me, it is completely OK.\r\n\r\nWell, I know I complaint a lot, I am just trying to convince myself that I don't need all of them. "}}