[Documentation Bug?] Markdown export

[Documentation Bug?] Markdown export

[Loris Bennett]

Hi,

On the page

  https://orgmode.org/manual/Markdown-export.html

the second line reads:

  Since md is built on top of the HTML back-end, any Org constructs not
  supported by Markdown, such as tables, the underlying html back-end
  (see HTML export) converts them.

My guess is that this should be

  Since md is built on top of the HTML back-end, any Org constructs not
  supported by Markdown, such as tables, are converted by the underlying
  html back-end (see HTML export).

However, I still don't understand what it means, so maybe my guess is
incorrect.

In any case, what will an Org table be converted to in the MD output?

Cheers,

Loris

-- 
Dr. Loris Bennett (Mr.)
ZEDAT, Freie Universität Berlin         Email loris.bennett@fu-berlin.de

Re: [Documentation Bug?] Markdown export

[John Kitchin]

[-- Attachment #1: Type: text/plain, Size: 1218 bytes --]

Org tables get exported as an html table.

John

-----------------------------------
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu


On Thu, Apr 19, 2018 at 12:47 AM, Loris Bennett <loris.bennett@fu-berlin.de>
wrote:

> Hi,
>
> On the page
>
>   https://orgmode.org/manual/Markdown-export.html
>
> the second line reads:
>
>   Since md is built on top of the HTML back-end, any Org constructs not
>   supported by Markdown, such as tables, the underlying html back-end
>   (see HTML export) converts them.
>
> My guess is that this should be
>
>   Since md is built on top of the HTML back-end, any Org constructs not
>   supported by Markdown, such as tables, are converted by the underlying
>   html back-end (see HTML export).
>
> However, I still don't understand what it means, so maybe my guess is
> incorrect.
>
> In any case, what will an Org table be converted to in the MD output?
>
> Cheers,
>
> Loris
>
> --
> Dr. Loris Bennett (Mr.)
> ZEDAT, Freie Universität Berlin         Email loris.bennett@fu-berlin.de
>
>
>

[-- Attachment #2: Type: text/html, Size: 2065 bytes --]

Re: [Documentation Bug?] Markdown export

[Nicolas Goaziou]

Hello,

"Loris Bennett" <loris.bennett@fu-berlin.de> writes:

> On the page
>
>   https://orgmode.org/manual/Markdown-export.html
>
> the second line reads:
>
>   Since md is built on top of the HTML back-end, any Org constructs not
>   supported by Markdown, such as tables, the underlying html back-end
>   (see HTML export) converts them.
>
> My guess is that this should be
>
>   Since md is built on top of the HTML back-end, any Org constructs not
>   supported by Markdown, such as tables, are converted by the underlying
>   html back-end (see HTML export).

I reworded the paragrpah. Thank you. The new introduction is:

    The Markdown export back-end, "md", converts an Org file to Markdown
    format, as defined at http://daringfireball.net/projects/markdown/.

    Since it is built on top of the HTML back-end (see [[*HTML Export]]), it
    converts every Org construct not defined in Markdown syntax, such as
    tables, to HTML.


Regards,

-- 
Nicolas Goaziou

Re: [Documentation Bug?] Markdown export

[Loris Bennett]

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Hello,
>
> "Loris Bennett" <loris.bennett@fu-berlin.de> writes:
>
>> On the page
>>
>>   https://orgmode.org/manual/Markdown-export.html
>>
>> the second line reads:
>>
>>   Since md is built on top of the HTML back-end, any Org constructs not
>>   supported by Markdown, such as tables, the underlying html back-end
>>   (see HTML export) converts them.
>>
>> My guess is that this should be
>>
>>   Since md is built on top of the HTML back-end, any Org constructs not
>>   supported by Markdown, such as tables, are converted by the underlying
>>   html back-end (see HTML export).
>
> I reworded the paragrpah. Thank you. The new introduction is:
>
>     The Markdown export back-end, "md", converts an Org file to Markdown
>     format, as defined at http://daringfireball.net/projects/markdown/.
>
>     Since it is built on top of the HTML back-end (see [[*HTML Export]]), it
>     converts every Org construct not defined in Markdown syntax, such as
>     tables, to HTML.

Thank you.  The meaning is now perfectly clear.

Cheers,

Loris

-- 
This signature is currently under construction.