It is true that certain metadata (author and date, to provide two examples) are used far more frequently than return addresses or URIs for graphical signatures. That said, it would be foolish to try to imagine every way in which metadata might be used, nor do I see much value in doing so.<div>
<br></div><div>If Markdown is to process metadata, the syntax should support arbitrary key–value pairs.</div><div><br></div><div>For example:</div><div><br></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    author: Jesper Nøhr</font></div>
<div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    date: 17 August 2011</font></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    tags: lol, omg, lulz</font></div>
<div><br></div><div>Formatted differently:</div><div><br></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    author: Jesper Nøhr</font></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    date: 17 August 2011</font></div>
<div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    tag: lol</font></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    tag: omg</font></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    tag: lulz</font></div>
<div><br></div><div>If — again, if — Markdown is to be charged with parsing metadata, my opinion is that it&#39;s role should be limited to returning a dictionary-like metadata object (in addition to the HTML string generated from the remainder of the document&#39;s contents).</div>
<div><br></div><div>For the first example:</div><div><br></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    {&quot;date&quot;: &quot;</font><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">17 August 2011&quot;, &quot;tags&quot;: &quot;</span><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">lol, omg, lulz&quot;, </span><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">&quot;author&quot;: &quot;</font><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">Jesper Nøhr&quot;</span><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">}</span></div>
<div><br></div><div>For the second example:</div><div><br></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">    {&quot;date&quot;: &quot;</font><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">17 August 2011</span><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">&quot;, &quot;author&quot;: &quot;</span><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">Jesper Nøhr&quot;,</span><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; "> &quot;tag&quot;: [&quot;lol&quot;, &quot;omg&quot;, &quot;lulz&quot;]}</span></div>
<div><br></div><div>In my opinion, Markdown should <i>not</i> be responsible for any of the following:</div><div><ul><li>splitting lists (note that &quot;lol, omg, lulz&quot; is a string in the first example)</li><li>converting date strings into date objects</li>
<li>any other manipulation of values</li></ul></div><div>In other words, every value should be either a string, or an ordered, list-like object containing two or more strings (in the case of a repeated key).</div><div><br>
</div><div>In addition to converting strings into appropriate objects, applications making use of Markdown&#39;s metadata feature would also be responsible for handling the fact that the value for a particular key may be a string for one document and a list of strings for another.</div>
<div><br></div><div>Fletcher touched on another question that should be discussed: should multiline values be accommodated and if so, how?</div><div><br></div><div>I think it&#39;d be great to support multiline strings. I imagine the formatting looking something like this:</div>
<div><br></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">author:</font></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">  </font><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">Jesper Nøhr</span></div>
<div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">date:</font></div><div><font class="Apple-style-span" face="&#39;courier new&#39;, monospace">  </font><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">17 August 2011</span></div>
<div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">lol:</span></div><div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  Irony keffiyeh pitchfork, mustache letterpress tofu cred twee scenester</span></div>
<div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  thundercats gluten-free yr chambray sartorial stumptown. Homo cosby sweater</span></div><div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  gentrify banh mi letterpress, vinyl beard hoodie terry richardson. Art party</span></div>
<div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  whatever banksy, readymade skateboard you probably haven&#39;t heard of them</span></div><div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  tumblr tattooed PBR letterpress photo booth carles vegan organic.</span></div>
<div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">omg:</span></div><div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  VHS carles photo booth food truck synth craft beer, wes anderson tofu banksy</span></div>
<div><span class="Apple-style-span" style="font-family: &#39;courier new&#39;, monospace; ">  fanny pack stumptown.</span></div><div><br></div><div>This strikes me as being in the spirit of Markdown, as it&#39;s how one might structure this content if one were to produce it on a typewriter.</div>
<div><br></div><div>I&#39;m interested to hear people&#39;s thoughts on multiline values and on the unfancy approach to metadata parsing that I (currently) favour.</div><div><br></div><div>David<br><br><div class="gmail_quote">
<br></div><div class="gmail_quote">On 17 August 2011 15:17, M Harris <span dir="ltr">&lt;<a href="mailto:mark@2011.n0b.org">mark@2011.n0b.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
So, hi all. First time commenting on the list.<br>
<br>
I personally think having tags (whether of type &quot;author:&quot; or type &quot;by&quot;)<br>
is useful for two reasons.<br>
One: It allows multiple tags to be entered. Two, it clears up the<br>
potential problem listed by Fletcher regarding tags.<br>
<br>
by Christoph Freitag<br>
Affiliation: XYZ<br>
by Fletcher T. Penney<br>
Affiliation: ABC<br>
tags: Markdown, Standardization, MMD, Metadata<br>
desc: An interesting discussion of how metadata could be included<br>
usefully in Markdown, whilst being readable etc.<br>
<br>
<br>
Regarding the localisation problem then, I thought that this was a<br>
solved problem when it came to computing? (At least in the cases of the<br>
major world languages.) A parser could have a table of equivalent words,<br>
so in English &quot;by&quot;, en français &quot;de&quot; (pardon my French*).<br>
<br>
* By which I mean, I&#39;m not sure that&#39;s correct, because I&#39;m only a<br>
learner.<br>
<br>
&gt; From: Christoph Freitag &lt;<a href="mailto:mail@christoph-freitag.de">mail@christoph-freitag.de</a>&gt;<br>
<div class="im">&gt; Fletcher, sorry, but personally -- despite loving MMD (and even having used MMD CMS for a diary) -- I have never liked the way MMD handles metadata. Partly this is because, not being a native English speaker, I dislike English meta descriptors. A localization could resolve this -- but I still think it looks ugly. However, do you actually need descriptors at all? I doubt it:<br>

&gt;<br>
&gt; *   The title could be anything &quot;at the start&quot; of the document. Blosxom is a good example. Anything up to the first blank line is the title.<br>
&gt; *   After that, anything between the first blank line and the second blank line would be treated as additional metadata.<br>
&gt; *   Instead of the &quot;Author:&quot; descriptor, explicitely stated, it should suffice to write &quot;by&quot;. What follows is the name of the author. (Localization would be easier as only this &quot;keyword&quot; would have to be known to the parser in a number of languages.)<br>

&gt; *   Dates would be self-explanatory, to a clever parser.<br>
&gt; *   Any list of words separated by commas on a single line would be treated as tags.<br>
&gt; *   Any more fanciful meta descriptors might be given explicitly just as in MMD before. This could be left to non-standard, personalized variants of Markdown.<br>
&gt;<br>
&gt; Thus the following would be a valid document:<br>
&gt;<br>
&gt; ---<br>
&gt; Test Document for Automatic Metadata Detection<br>
&gt;<br>
&gt; by Christoph Freitag<br>
&gt; 08/17/2011<br>
&gt; Markdown, Standardization, MMD, Metadata<br>
&gt;<br>
&gt; A Markdown document may contain metadata in a human readable form that the parser converts to a machine readable form of metadata automatically. A casual reader will understand the content directly and without distraction. Bowerbird will love this.<br>

<br>
<br>
</div>&gt; From: &quot;Fletcher T. Penney&quot; &lt;<a href="mailto:fletcher@fletcherpenney.net">fletcher@fletcherpenney.net</a>&gt;<br>
<div class="im"><br>
&gt; You mention the English-centric nature of MMD metadata.  This is certainly true, but no more so than HTML itself.  One could certainly localize MMD to use any language you like (the beauty of open source), but to match your proposal in multiple languages would be quite complicated.<br>

&gt;<br>
&gt; For example, the following are valid MMD metadata dates, and easily used:<br>
&gt;<br>
&gt;       date:   8/17/2011<br>
&gt;       date:   August 17th, 2011<br>
&gt;       date:   2011-08-17<br>
&gt;       date:   17/8/2011<br>
&gt;       date:   14. Juni 2001<br>
&gt;       date:   8 avril 2000<br>
&gt;<br>
&gt; Writing a parser that would correctly catch all of these dates in any language would be quite difficult, and prone to error.<br>
&gt;<br>
&gt; You mention tags as being easily recognized, but that this is not always true:<br>
&gt;<br>
&gt;       A sample document<br>
&gt;<br>
&gt;       by John Smith, MD<br>
&gt;       Director of Palliative Care, Division of General Medicine, Medical University of Somewhere<br>
&gt;<br>
&gt; While perhaps not the best example of potential problems, this would be incorrectly interpreted as tags, when the author probably implies that this represents his academic affiliation and would like it to be properly placed after his name on the title page, or on the slide deck if generating via beamer.<br>

<br>
<br>
<br>
</div><div><div></div><div class="h5">_______________________________________________<br>
Markdown-Discuss mailing list<br>
<a href="mailto:Markdown-Discuss@six.pairlist.net">Markdown-Discuss@six.pairlist.net</a><br>
<a href="http://six.pairlist.net/mailman/listinfo/markdown-discuss" target="_blank">http://six.pairlist.net/mailman/listinfo/markdown-discuss</a><br>
</div></div></blockquote></div><br></div>