Markdown Discuss - May 2011 - What does Markdown do with HTML comments? Recommendation on Markdown file extension?

Hi there!

(1.)

It may sound awkward, but I would like to use comments in Markdown texts.
According to the rule that proper HTML works as HTML, I should be able to
use

    <!--  blablabla -->

But the converters I use do strange things with comments. Is there an
official rule about that?


(2.)

I wonder if there is a recommended standard file extension for Markdown
source files.
For my own files I always use `.markdown`.
But other important sources seem to prefer `.text`.

Do you have an opinion on that, or is there even a standard?
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://six.pairlist.net/pipermail/markdown-discuss/attachments/20110505/1cc139a9/attachment.htm>

On Wed, May 4, 2011 at 9:03 PM, bucephalus org <bucephalus.org at
gmail.com> wrote:
> Hi there!
> (1.)
> It may sound awkward, but I would like to use comments in Markdown texts.
> According to the rule that proper HTML works as HTML, I should be able to
> use
> ? ? <!-- ?blablabla -->
> But the converters I use do strange things with comments. Is there an
> official rule about that?
As you can see here [1], most implementations pass comments through.

[1]: http://babelmark.bobtfish.net/?markdown=<%21--++blablabla+-->
>
> (2.)
> I wonder if there is a recommended standard file extension for Markdown
> source files.
> For my own files I always use `.markdown`.
> But other important sources seem to prefer `.text`.
> Do you have an opinion on that, or is there even a standard?
>
This has been a hotly debated topic in the past and IIRC J. Gruber
(the creator of Markdown) has indicated that he will not support a
standard and he personally uses '.text'. However, most projects I'm
aware of use '.md' or '.markdown'. Personally, I prefer
'.txt' or
'.text' but notice what happened when I requested that github work
with that [2].

[2]: https://github.com/mojombo/jekyll/issues/230



-- 
----
\X/ /-\ `/ |_ /-\ |\|
Waylan Limberg

* bucephalus org <bucephalus.org at gmail.com> [2011-05-05 03:03:05 +0200]
wrote :
> Hi there!
Hi ;)

[...]
> (2.)
> 
> I wonder if there is a recommended standard file extension for Markdown
> source files.
> For my own files I always use `.markdown`.
> But other important sources seem to prefer `.text`.
> 
> Do you have an opinion on that, or is there even a standard?
On my side, I'm using .mkd ... Can't remember exactly where I saw that
one ... but works fine for vim :)

-- 
 .''`.  Edi Stojicevic
: :'  : Debian GNU/Linux user, admin & developer - http://www.debian.org
`. `~'  Debianworld - http://www.debianworld.org 
  `-    
Linux is obsolete
		-- Andrew Tanenbaum

Hello.

Not having tried to use MultiMarkdown for comments, but knowing that they work
for including
raw latex, I can't see why they shouldn't work for html as comments.

I ran this test:

---- MMD document:
## comment test html
<!-- Man I really need some deep thoughts about this -->
To comment or not comment is a question about reflection.

-- Resulting html:
<h2 id="commenttesthtml">comment test html</h2>

<!-- Man I really need some deep thoughts about this -->

<p>To comment or not comment is a question about reflection.</p>
 
hth

Tommy

Den 5. mai 2011 kl. 03.03 skrev bucephalus org:
> Hi there!
> 
> (1.)
> 
> It may sound awkward, but I would like to use comments in Markdown texts.
> According to the rule that proper HTML works as HTML, I should be able to
> use
> 
>    <!--  blablabla -->
> 
> But the converters I use do strange things with comments. Is there an
> official rule about that?
> 
> 
> (2.)
> 
> I wonder if there is a recommended standard file extension for Markdown
> source files.
> For my own files I always use `.markdown`.
> But other important sources seem to prefer `.text`.
> 
> Do you have an opinion on that, or is there even a standard?
> _______________________________________________
> Markdown-Discuss mailing list
> Markdown-Discuss at six.pairlist.net
> http://six.pairlist.net/mailman/listinfo/markdown-discuss
Best regards



Tommy Bollman
--------------------------------------------------------------------------------------------------
Mollison's Bureaucracy Hypothesis:
	If an idea can survive a bureaucratic review
	and be implemented it wasn't worth doing.