md4c

C Markdown parser. Fast. SAX-like interface. Compliant to CommonMark specification.
git clone https://noulin.net/git/md4c.git
Log | Files | Refs | README | LICENSE

permissive-email-autolinks.txt (1511B)


      1 
      2 # Permissive E-mail Autolinks
      3 
      4 With the flag `MD_FLAG_PERMISSIVEEMAILAUTOLINKS`, MD4C enables more permissive
      5 recognition of e-mail addresses and transforms them to autolinks, even if they
      6 do not exactly follow the syntax of autolink as specified in CommonMark
      7 specification.
      8 
      9 This is standard CommonMark e-mail autolink:
     10 
     11 ```````````````````````````````` example
     12 E-mail: <mailto:john.doe@gmail.com>
     13 .
     14 <p>E-mail: <a href="mailto:john.doe@gmail.com">mailto:john.doe@gmail.com</a></p>
     15 ````````````````````````````````
     16 
     17 With the permissive autolinks enabled, this is sufficient:
     18 
     19 ```````````````````````````````` example
     20 E-mail: john.doe@gmail.com
     21 .
     22 <p>E-mail: <a href="mailto:john.doe@gmail.com">john.doe@gmail.com</a></p>
     23 ````````````````````````````````
     24 
     25 `+` can occur before the `@`, but not after.
     26 
     27 ```````````````````````````````` example
     28 hello@mail+xyz.example isn't valid, but hello+xyz@mail.example is.
     29 .
     30 <p>hello@mail+xyz.example isn't valid, but <a href="mailto:hello+xyz@mail.example">hello+xyz@mail.example</a> is.</p>
     31 ````````````````````````````````
     32 
     33 `.`, `-`, and `_` can occur on both sides of the `@`, but only `.` may occur at
     34 the end of the email address, in which case it will not be considered part of
     35 the address:
     36 
     37 ```````````````````````````````` example
     38 a.b-c_d@a.b
     39 
     40 a.b-c_d@a.b.
     41 
     42 a.b-c_d@a.b-
     43 
     44 a.b-c_d@a.b_
     45 .
     46 <p><a href="mailto:a.b-c_d@a.b">a.b-c_d@a.b</a></p>
     47 <p><a href="mailto:a.b-c_d@a.b">a.b-c_d@a.b</a>.</p>
     48 <p>a.b-c_d@a.b-</p>
     49 <p>a.b-c_d@a.b_</p>
     50 ````````````````````````````````