From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: orgmode to markdown
Date: Thu, 04 Jun 2015 00:18:02 +0200
Message-ID: <877frksag5.fsf@nicolasgoaziou.fr>
References: <1433064971.9859.25.camel@sindominio.net>
	<87iob85rd2.fsf@nicolasgoaziou.fr>
	<1433237666.15774.24.camel@sindominio.net>
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]:55649)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1Z0Gxk-0000TE-1W
	for emacs-orgmode@gnu.org; Wed, 03 Jun 2015 18:16:40 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1Z0Gxi-000166-VF
	for emacs-orgmode@gnu.org; Wed, 03 Jun 2015 18:16:39 -0400
Received: from relay4-d.mail.gandi.net ([2001:4b98:c:538::196]:49495)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1Z0Gxi-00015x-PJ
	for emacs-orgmode@gnu.org; Wed, 03 Jun 2015 18:16:38 -0400
In-Reply-To: <1433237666.15774.24.camel@sindominio.net> (flow's message of
	"Tue, 02 Jun 2015 11:34:26 +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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: flow <adolflow@sindominio.net>
Cc: emacs-orgmode@gnu.org

flow <adolflow@sindominio.net> writes:

> I guessed setext support 6 levels so I don't know why ox-md supprot just
> 2 levels although my exporter seems to support 3 levels. Why?

Setext style supports only 2 levels. Atx supports 6 of them, per
<http://daringfireball.net/projects/markdown/syntax#header>.

> That's a good question but not what I wanted to know. What I want -and
> I would like to know whay ox-md doesn't- is to export org as org-mode
> to html does:
>
> - The title becomes h1, so the org title becomes # or ===, I don't mind
> - The * becomes h2, so the org * becomes ## or ----
> - The ** becomes h3, so the org ** becomes ### (in case it supports 3
> leveles)
> - etc.
>
> What do you think about it?

I think it is very opinionated and may be undesirable in the general
case. It means that every headline would be numbered 1.xxx. 

Also some Markdown extensions provide meta-data keywords to specify,
e.g., the title of the document. This behaviour would just get in the
way for them since headlines would get one too many level with no real
reason.

There are several workarounds:

  - you can define filters to add another level to each headline and
    title at the beginning of the document.

  - you can use a {{{title}}} macro, e.g.,

      @@md:#@@ {{{title}}}

    and shift other headlines

If this is common enough, we could also add a defcustom to toggle this
behaviour (yet, off by default). But is it common enough?


Regards,