Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
Hello, > Note: I will try to put a static site together later this > week (using the same page, thanks to GitHub pages with built in > Markdown processing ;-) FYI: The "prettified" (static site) GitHub page version is now online [1]. Again thanks for all comments and corrections. Cheers. [1] http://writekit.github.io ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
On 5 Aug 2015, at 9:06, Tom Humiston wrote: On Aug 4, 2015, at 10:26 AM, Gerald Bauer wrote: thus, before e.g. less typing They're not equivalent — there's far more difference than the amount of typing, and they ought not be considered interchangeable. _When used as intended, the em and strong units are almost always preferable over the i and b elements._ I’m glad you quoted the specs. However, I wouldn’t say "almost always preferable", as it really depends on what you’re doing & what the content is. A lot of times, client websites that we’re working on end up using & far more than & . Again, it just depends. In short, Gerald, in the guide you're preparing I wouldn't mention and in connection with Markdown's *em* and **strong** syntax, because they're really for something else. The problem is that Markdown is so old that it pre-dates HTML5, which re-defined & re-emphasized the distinctions between what *appear* to be similar elements. Because of its age, Markdown doesn’t really provide a way to include & , which is understandable but unfortunate. Scott -- R. Scott Granneman sc...@granneman.com ~ www.granneman.com Contact info: granneman.tel “At every crossroads on the path that leads to the future, tradition has placed 10,000 men to guard the past.” ---Maurice Maeterlink ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
On 5 Aug 2015, at 15:06, Tom Humiston wrote: In short, Gerald, in the guide you're preparing I wouldn't mention and in connection with Markdown's *em* and **strong** syntax, because they're really for something else. not to disagree with your point (but rather to agree: Gruber is careful to say 'emphasis' when defining this) but any committee that had the time to distinguish to that extent between what is traditionally done with italics (and frankly, is a false set of distinctions since everything under '' is traditionally italicised *for emphasis* (sic)) is a committee that needed to get out more;)___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
On Aug 4, 2015, at 10:26 AM, Gerald Bauer wrote: > > thus, before e.g. less typing They're not equivalent — there's far more difference than the amount of typing, and they ought not be considered interchangeable. _When used as intended, the em and strong units are almost always preferable over the i and b elements._ Fortunately, in most cases the elements produced by Markdown syntax are the appropriate ones; and can be specified explicitly in the rare cases where they're suitable. From the spec: > The [em element][1] represents stress emphasis of its contents. > The [strong element][2] represents strong importance, seriousness, or urgency > for its contents. > The [i element][3] represents a span of text in an alternate voice or mood, > or otherwise offset from the normal prose in a manner indicating a different > quality of text, such as a taxonomic designation, a technical term, an > idiomatic phrase from another language, transliteration, a thought, or a ship > name in Western texts. > The [b element][4] represents a span of text to which attention is being > drawn for utilitarian purposes without conveying any extra importance and > with no implication of an alternate voice or mood, such as key words in a > document abstract, product names in a review, actionable words in interactive > text-driven software, or an article lede. In addition to those definitions, the spec has concise guidance on when, how, and why to use each element, as well as code examples of each. In short, Gerald, in the guide you're preparing I wouldn't mention and in connection with Markdown's *em* and **strong** syntax, because they're really for something else. HTH, Thomas [1]: http://www.w3.org/html/wg/drafts/html/master/semantics.html#the-em-element [2]: http://www.w3.org/html/wg/drafts/html/master/semantics.html#the-strong-element [3]: http://www.w3.org/html/wg/drafts/html/master/semantics.html#the-i-element [4]: http://www.w3.org/html/wg/drafts/html/master/semantics.html#the-b-element ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
Hello, Thanks. Sorry my mistake. > Shouldn't it be ? There's no such thing as in HTML. It's now corrected to . Cheers. ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
> On Aug 4, 2015, at 10:48 AM, Michel Fortin wrote: > >> Le 2015-08-04 à 10:26, Gerald Bauer a écrit : >> >> Thanks great comments. I've update the quick reference and it reads now >> >> or and >> or > > Shouldn't it be ? There's no such thing as in HTML. You are correct. Sorry, my mistake. Waylan Limberg ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
Le 2015-08-04 à 10:26, Gerald Bauer a écrit : > Thanks great comments. I've update the quick reference and it reads now > >or and >or Shouldn't it be ? There's no such thing as in HTML. -- Michel Fortin michel.for...@michelf.ca https://michelf.ca smime.p7s Description: S/MIME cryptographic signature ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
Hello, Thanks great comments. I've update the quick reference and it reads now or and or Thanks for the comments on XHTML - might add a footnote or something. The idea (target audience) of the reference is a HTML coders new to Markdown (thus, before e.g. less typing etc. same for and etc.) By the way, the quick reference is decidated to the public doman (e.g. no copyright, no rights reserved) - (re)use and copy as you please. Note: I will try to put a static site together later this week (using the same page, thanks to GitHub pages with built in Markdown processing ;-) Cheers. ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
It is vary unusual for Markdown parsers to return and tags. Usually, and are used instead. See Babelmark for an example: http://johnmacfarlane.net/babelmark2/?normalize=1&text=*italic*+%26+**bold** Also, most older implementations return XHTML Tags like and rather than there HTML counterparts. In the age of HTML5, this doesn't really matter much (for most users), but back when they were first created it was important to having valid XHTLM (the new hotness of the time). Of note is the fact that and are not valid XHTML tags (IIRC). Thus the use of and . Waylan Limberg > On Aug 4, 2015, at 5:16 AM, Gerald Bauer wrote: > > Hello, > > I've started a quick reference that lists all HTML tag with Markdown > "short codes" [1]. The tags include: > > HTML| Notes > --- | - > ... - ... | Heading 1-6 > ... | Paragraph > | Hard Line Break > ... | Italic Text (Emphasis) > ... | Bold Text (Strong Emphasis) > ...| Code (Monospace Text) > ... | Deleted (Strikethrough) Text > (...)+| Unordered List > (...)+| Ordered (Numbered) List > ... | Link >| Image (with Alternative Text) > ((...)+)+ | Table > ... | Preformatted Code Block > ... | Blockquote > | Horizontal Rule > | Comments > > > Any tags missing? Let us know. Cheers > > [1] https://github.com/writekit/quickrefs/blob/master/HTML.md > ___ > Markdown-Discuss mailing list > Markdown-Discuss@six.pairlist.net > https://pairlist6.pair.net/mailman/listinfo/markdown-discuss ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
Hello, Thanks for your comments and the great Markdown Extra library. Will try to add the and tags and footnotes, glossary entries, citations and definition lists. The more the better. I "target" if I dare to say "common" Markdown - or let's say "Webster's" Markdown e.g. it works like an English dictionary - I collect all variants (British English, American, Newfie, etc.) in use. Cheers. ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
Re: HTML Tags <=> Markdown Quick Reference @ Write Kit
Le 2015-08-04 à 5:16, Gerald Bauer a écrit : > Any tags missing? Let us know. Cheers Which variant of Markdown are you targeting? Many of those are not available in the reference implementation of Markdown (the one on Daring Fireball). While if you use Markdown Extra you have footnotes, definition lists, and abbreviations which are not on your list. MultiMarkdown also has a syntax for , , and , glossary entries, citations, and maths. There is a wide variation of what is available depending on the parser you use. Also, not all features map cleanly to an HTML tag (footnotes for instance). -- Michel Fortin michel.for...@michelf.ca https://michelf.ca smime.p7s Description: S/MIME cryptographic signature ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
HTML Tags <=> Markdown Quick Reference @ Write Kit
Hello, I've started a quick reference that lists all HTML tag with Markdown "short codes" [1]. The tags include: HTML| Notes --- | - ... - ... | Heading 1-6 ... | Paragraph | Hard Line Break ... | Italic Text (Emphasis) ... | Bold Text (Strong Emphasis) ...| Code (Monospace Text) ... | Deleted (Strikethrough) Text (...)+| Unordered List (...)+| Ordered (Numbered) List ... | Link | Image (with Alternative Text) ((...)+)+ | Table ... | Preformatted Code Block ... | Blockquote | Horizontal Rule | Comments Any tags missing? Let us know. Cheers [1] https://github.com/writekit/quickrefs/blob/master/HTML.md ___ Markdown-Discuss mailing list Markdown-Discuss@six.pairlist.net https://pairlist6.pair.net/mailman/listinfo/markdown-discuss
