From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jay Kamat <jaygkamat@gmail.com>
Subject: Re: [PATCH] Add TITLE export to ox-md
Date: Sun, 27 Aug 2017 22:43:38 -0400
Message-ID: <871snw4dk5.fsf@gmail.com>
References: <87fuchzllk.fsf@gmail.com> <87a82p1fey.fsf@nicolasgoaziou.fr>
	<CAFyQvY00b0Ouuz7LuQvRK4cWYc6Sdsdt_gNc8tD-MD2uRLvxSQ@mail.gmail.com>
	<87ziaphvu7.fsf@gmail.com> <87y3q6wxxp.fsf@nicolasgoaziou.fr>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47834)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jaygkamat@gmail.com>) id 1dmA1j-0000cS-0U
	for emacs-orgmode@gnu.org; Sun, 27 Aug 2017 22:43:48 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jaygkamat@gmail.com>) id 1dmA1f-0001UE-TK
	for emacs-orgmode@gnu.org; Sun, 27 Aug 2017 22:43:47 -0400
Received: from mail-yw0-x241.google.com ([2607:f8b0:4002:c05::241]:33406)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <jaygkamat@gmail.com>) id 1dmA1f-0001SS-Nw
	for emacs-orgmode@gnu.org; Sun, 27 Aug 2017 22:43:43 -0400
Received: by mail-yw0-x241.google.com with SMTP id w138so878491yww.0
	for <emacs-orgmode@gnu.org>; Sun, 27 Aug 2017 19:43:42 -0700 (PDT)
In-Reply-To: <87y3q6wxxp.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of
	"Sat, 26 Aug 2017 10:11:30 +0200")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Cc: emacs-org list <emacs-orgmode@gnu.org>, Kaushal Modi <kaushal.modi@gmail.com>

Hi, 

> The point of "md" export back-end is not to provide the same features as
> full-fledged ones like "latex" or "html". I wrote it to take care of the
> boring stuff of markdown syntax. Anyone willing to write a back-end with
> a different Markdown flavour just needs to concentrate of the
> differences between the original syntax.

Ah, this makes a lot more sense now. I think that this patch is better suited
towards more specific md backends (like ox-hugo or ox-gfm), so they can
implement title in the way that supports their import the best. Adding this
probably would get in the way of better title exports for the respective org
exporter derivations.

> AFAIC, I think <title>...</title> or even <header>...</header>
> <main>...</main>, as you suggested, are better choices.

I do agree (from creating a vanilla markdown exporter standpoint), but I dislike
it purely because the github markdown renderer doesn't display inline html that
well (even though that's per standard). It ranges from being displayed as a H1
header to being displayed as normal (non-heading) text, depending on the way
it's done.

In summary, I think I'll try to get this into ox-gfm (and other org md exporters
I can find) instead of ox-md. I think ox-hugo supports titles already though.
Thanks again for taking a look at this!

-Jay