Le 2007-12-04 à 16:29, Thomas Nichols a écrit :

I've been using the ~~~ syntax for marking code blocks for a few weeks,
and it's certainly an improvement over the existing four-space indent.
However, it can be difficult to see at a glance where one code block
begins and another ends, as in the following example:

some normal text

~~~~

some code

~~~~

some more code... no, wait...

~~~~

now *this* is code

~~~~

and this ... errrr ...

~~~~

You get the idea. This mostly becomes a problem when writing technical
docs with frequent chunks of embedded code, and the solution would
appear to be to have different markup for begin-block and end-block.

That's a good observation.

I'm wondering though if you really want each one of your code blocks to start and end with a blank line; one advantage of this syntax is that you can have a blank line at the start or the end of the code block which you can't with the indented syntax, but using it this way all the time seems rather unusual.

Well, of course, you can always parse flat code blocks by removing leading and tailing blank lines, but this doesn't seem to reflect very well what a reader reading the original Markdown-formatted text would understand from it, and it'd remove one interesting (though rarely-needed) advantage of this code block syntax..


Michel Fortin
[EMAIL PROTECTED]
http://michelf.com/


_______________________________________________
Markdown-Discuss mailing list
[email protected]
http://six.pairlist.net/mailman/listinfo/markdown-discuss

Reply via email to