Markdown Discuss - Aug 2015 - HTML Tags <=> Markdown Quick Reference @ Write Kit

Hello,

   Thanks great comments. I've update the quick reference and it reads now

   <i> or <emphasis>    and
   <b> or <strong>

   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, <i> before <emphasis> e.g. less typing
etc. same for <br> and <br /> 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.

Le 2015-08-04 ? 10:26, Gerald Bauer <gerald.bauer at gmail.com> a ?crit :
>   Thanks great comments. I've update the quick reference and it reads
now
> 
>   <i> or <emphasis>    and
>   <b> or <strong>
Shouldn't it be <em>? There's no such thing as <emphasis> in
HTML.

-- 
Michel Fortin
michel.fortin at michelf.ca
https://michelf.ca

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4939 bytes
Desc: not available
URL:
<https://pairlist6.pair.net/pipermail/markdown-discuss/attachments/20150804/8c3ff70a/attachment-0001.bin>

On Aug 4, 2015, at 10:26 AM, Gerald Bauer <gerald.bauer at gmail.com>
wrote:
> 
> thus, <i> before <em> 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; <i> and <b> 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
<i> and <b> 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

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