Mysterious MD5ification under very specific circumstances

[Fletcher Penney]

By "markdown v.1.0.1" I'm guessing he meant Gruber's Perl Markdown.pl 1.0.1.


As for whom to report the bug, Gruber's Markdown.pl is presumably not going to be updated further, and has not been updated in years (also known as an eternity in internet time...  ;).  Certainly someone on this list may have an interest in finding the bug and posting a fix, but you may be better off switching to a variant of Markdown that is still undergoing active development.  As Waylan hinted, there are lots, and I'm sure everyone on the list has their favorites.  Heck, many people on this list have written their own (myself included).....

When choosing a variant, some things to consider:

* What languages (if any) are you comfortable with if you want to change anything?  If you're not changing anything, this may not matter.

* Are you using Markdown in a larger project where the choice of language will have a significant impact on ease of use?

* How important is performance --- there can be several orders of magnitude difference between implementations?

* Do you need extensions to the basic Markdown syntax (e.g. footnotes, tables, etc.)?



My own implementation, for example is [MultiMarkdown](http://fletcherpenney.net/multimarkdown/).  It is written in C and is designed to compile on pretty much anything.  Once installed, you have a simple binary that is extremely fast and easy to use, and offers a few command line options.  It's easily used in shell scripts, and most languages offer the equivalent of a "system()" call so you can use external utilities inside of Perl, ruby, etc.  It offers a bunch of extra features that many believe were missing from the original Markdown, but you can turn those off with the compatibility mode to imitate the output from "standard markdown", minus most of the bugs.  ;)


Fletcher




On Jun 28, 2013, at 12:32 PM, Waylan Limberg <waylan at gmail.com> wrote:


> Wolfgang,

> 

> Which implementation of the markdown parser are you using? Perl, php, ruby, python, javascript, ... (and many more) and which version specificly?

> 

> Ask to an explaination, some implementations of the parser use MD5 Hashes as placeholders for the already parsed pieces of the document. My guess is that you found an edge case which tripps up the code that swaps out the placeholders for the parsed html.

> 

> Waylan Limberg 

> waylan at gmail.com

> 

> On Jun 28, 2013 11:55 AM, "Wolfgang Faust" <wolfgangmcq at gmail.com> wrote:

> I was building a markdown document today when my document suddenly went blank. When I looked at the HTML source, I found that all my codeblocks had been MD5ified. The following is a minimal document which reproduces the error:

> 

> # Header #

> <!-- There can be text here, but there doesn't have to be.

> 	>> -->

> 

> 	This is a codeblock.

> 

> **Bold text** <!-- Another comment -->

> 

> In particular, there must be:

> 	• A header

> 	• A comment containing the sequence NEWLINE TAB followed by at least two greater-than signs

> 	• At least one codeblock

> 	• Bold text

> 	• Another comment at the end of the document.

> Changing even the smallest detail in the markdown results in a correct HTML document, as expected.

> 

> When I run this through markdown v.1.0.1, I get:

> <h1>Header</h1>

> 

> <!--

> 

> 

> 702c6078df02d6d43aa6003f415a0408

> 

> 

> </blockquote>

> 

> 

> 

> 46815d21b36c42e3ef8dcf757dd5758a

> 

> 

> 

> **Bold text** <!-- Another comment -->

> 

> What on earth is going on here, and who do I report this bug to?

> 

> _______________________________________________

> Markdown-Discuss mailing list

> Markdown-Discuss at six.pairlist.net

> http://six.pairlist.net/mailman/listinfo/markdown-discuss

> 

> _______________________________________________

> Markdown-Discuss mailing list

> Markdown-Discuss at six.pairlist.net

> http://six.pairlist.net/mailman/listinfo/markdown-discuss



-- 
Fletcher T. Penney
fletcher at fletcherpenney.net 

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4899 bytes
Desc: not available
Url : <http://six.pairlist.net/pipermail/markdown-discuss/attachments/20130628/381ba42c/attachment.bin>