On Wed, Nov 30, 2011 at 9:27 AM, Andy Bennett <[email protected]> wrote: > I'm writing a Markdown Parser in Scheme by porting bits of Markdown.pl. > [clip] > > There seems to be a discrepancy between the "Markdown: Syntax" document > and the implementation in _HashHTMLBlocks.
I suspect this post [1] by Gruber himself in the list archive will shed some light on your conundrum. The issue has come up numerous times since, but that is the latest response I could find by JG on the subject. The point is, when you find a conflict between the documentation and the implementation - the documentation rules. However, when the documentation is silent, most of us rely on the implementation as a guide. Personally, what I find helpful is the existing test suite. Some of the examples in there shed light on the intended behavior. It doesn't hurt to run the test suites from other implementations as well. If you haven't already, you might want to run your test cases through babelmark [2] and see what results you get. Sometimes when I can't find an existing test and no specific documentation on an edge case, I go with the most common behavior among implementations on babelmark. Although, be aware that some of those implementations are a little outdated. [1]: http://six.pairlist.net/pipermail/markdown-discuss/2008-February/001001.html [2]: http://babelmark.bobtfish.net/ -- ---- \X/ /-\ `/ |_ /-\ |\| Waylan Limberg _______________________________________________ Markdown-Discuss mailing list [email protected] http://six.pairlist.net/mailman/listinfo/markdown-discuss
