- From: Shane McCarron <ahby@aptest.com>
- Date: Wed, 21 Nov 2012 08:29:29 -0600
- To: Dave Pawson <dave.pawson@gmail.com>
- Cc: Markdown List <public-markdown@w3.org>
- Message-ID: <CAOk_reFbh9hh03tTPiXFEUq7uMMy9xEyQHStuWtV8XVQwTAG7g@mail.gmail.com>
I don't think there is anything wrong with supporting all of those, although there would need to be a precedence order for error recovery. Why do I think that? Because one purpose for MD is that the document be not just human readable in source form, but also that the human readable version be pretty. # header # is way less pretty than header followed by a line of equals signs. Also, I would like to propose that in the # header # form, text after the trailing # be used as the identifier for the header: # A Header # myHeaderID should generate <h1 id="myHeaderID">A Header</h1> in (X)HTML I feel like there is already support for this in some implementations, and it would make referencing sections from elsewhere in the document way easier. As to processing precedence order, I think it should be: 1. # headerText with optional trailing # and optional ID text 2. headerText followed by /^=+/ or /^-+/ If a processor encounters both, the header level determined from (1) above is used, and the dividing line is ignored. On Wed, Nov 21, 2012 at 6:51 AM, Dave Pawson <dave.pawson@gmail.com> wrote: > On 21 November 2012 11:35, Dave Pawson <dave.pawson@gmail.com> wrote: > > The current MD has numerous options for headers. > > http://daringfireball.net/projects/markdown/syntax#header > > > > Two forms of underscore, > > what is called the 'atx' header, which has optional termination > indicators. > > > > I'd propose that we adopt one. > > > > Options. > > > > 1. == underscore (any length > 1 on following line, starting column 1) > > 2. -- hyphen underscore (any length > 1 on following line, starting > column 1) > > 3. # header text # where # is 1..6 repeat for different levels > > 4. # header text where # is 1..6 repeat for different levels > > > > My preference is for option 3. > > > > Please let us know which one you like, or whether you would like to > > support multiple versions. > > > > > > Issues: Unlike paragraphs, the 'start' indicator must be in column 1? > E.g. > > #heading# is not seen as a heading? > > This appears inconsistant with para level block markup? > > Inconsistent in 'error recovery' > > # Both # in column 1 and === beneath. Transform to h1 > == > > # H1 in # start, --- beneath. Shows as h2 > ---- > > I.e. there would appear to be a hierarchy or ordering. > > regards > > > -- > Dave Pawson > XSLT XSL-FO FAQ. > Docbook FAQ. > http://www.dpawson.co.uk > > -- Shane P. McCarron Managing Director, Applied Testing and Technology, Inc.
Received on Wednesday, 21 November 2012 14:30:02 UTC