[bug] [new exporter] [markdown] Underline exports as HTML

[bug] [new exporter] [markdown] Underline exports as HTML

[T.F. Torrey]

Hello,

The new markdown exporter (which I didn't think I'd use, but now greatly
appreciate) seems to export underlines as HTML rather than markdown.

In other words, this:

The _second_ thing.

exports as this:

The <span style="text-decoration:underline;">second</span> thing.

I'm not experienced with markdown, but this doesn't look right to me.

Emacs  : GNU Emacs 24.3.50.1 (i686-pc-linux-gnu, GTK+ Version 3.6.0)
 of 2012-12-24 on menkib, modified by Debian
Package: Org-mode version 8.0-pre (release_8.0-pre-36-g0c7e2c @ /home/tftorrey/.emacs.d/elisp/org/lisp/)

All the best,
Terry
-- 
T.F. Torrey

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Bastien]

Hi Terry,

tftorrey@tftorrey.com (T.F. Torrey) writes:

> I'm not experienced with markdown, but this doesn't look right to
> me.

I fixed this in master.  

AFAIK there is no syntax for underlining in Markdown, so underlined
text in Org will be exported as plain text in Markdown.

See
http://stackoverflow.com/questions/3003476/get-underlined-text-with-markdown

Thanks for reporting this,

-- 
 Bastien

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Rick Frankel]

On Tue, Mar 12, 2013 at 12:06:55AM +0100, Bastien wrote:
> Hi Terry,
> 
> tftorrey@tftorrey.com (T.F. Torrey) writes:
> 
> > I'm not experienced with markdown, but this doesn't look right to
> > me.
> 

> AFAIK there is no syntax for underlining in Markdown, so underlined
> text in Org will be exported as plain text in Markdown.

I would argue that underlining is a form of emphasis, so the leading
and trailing underscores should be passed through verbatim to
markdown (which, in markdown syntax is an emphasized span).

rick

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Bastien]

Rick Frankel <rick@rickster.com> writes:

> On Tue, Mar 12, 2013 at 12:06:55AM +0100, Bastien wrote:
>> Hi Terry,
>> 
>> tftorrey@tftorrey.com (T.F. Torrey) writes:
>> 
>> > I'm not experienced with markdown, but this doesn't look right to
>> > me.
>> 
>
>> AFAIK there is no syntax for underlining in Markdown, so underlined
>> text in Org will be exported as plain text in Markdown.
>
> I would argue that underlining is a form of emphasis, so the leading
> and trailing underscores should be passed through verbatim to
> markdown (which, in markdown syntax is an emphasized span).

Yes, I see your point -- it's now the case.

Thanks!

-- 
 Bastien

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Nicolas Goaziou]

Hello,

Bastien <bzg@altern.org> writes:

> Rick Frankel <rick@rickster.com> writes:
>
>> On Tue, Mar 12, 2013 at 12:06:55AM +0100, Bastien wrote:
>>> Hi Terry,
>>> 
>>> tftorrey@tftorrey.com (T.F. Torrey) writes:
>>> 
>>> > I'm not experienced with markdown, but this doesn't look right to
>>> > me.
>>> 
>>
>>> AFAIK there is no syntax for underlining in Markdown, so underlined
>>> text in Org will be exported as plain text in Markdown.
>>
>> I would argue that underlining is a form of emphasis, so the leading
>> and trailing underscores should be passed through verbatim to
>> markdown (which, in markdown syntax is an emphasized span).
>
> Yes, I see your point -- it's now the case.

AFAIU, one Markdown feature is to accept raw HTML as part of the syntax.
So, what's wrong in writing in HTML code anything that is not directly
supported by Markdown syntax (like tables)?


Regards,

-- 
Nicolas Goaziou

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Bastien]

Hi Nicolas,

Nicolas Goaziou <n.goaziou@gmail.com> writes:

> AFAIU, one Markdown feature is to accept raw HTML as part of the syntax.
> So, what's wrong in writing in HTML code anything that is not directly
> supported by Markdown syntax (like tables)?

Nothing wrong /per se/ but, I modified `org-html-underline' so that it
uses a specific class "underline" instead of hardcoding the style.

(There is no style="..." parameter left in the HTML export.)

<span class="underline">text</span> does not mean anything for
Markdown.

We could have org-md-underline to export to <u>text</u> but this tag
is deprecated in xhtml and html5.

As for using <span style="text-decoration: underline;">text</span> 
I think it goes against Markdown's philosophy to keep things light.

So on the overall, I find using `org-md-verbatim' a quite good
trade-off.

-- 
 Bastien

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Eric Schulte]

Nicolas Goaziou <n.goaziou@gmail.com> writes:

> Hello,
>
> Bastien <bzg@altern.org> writes:
>
>> Rick Frankel <rick@rickster.com> writes:
>>
>>> On Tue, Mar 12, 2013 at 12:06:55AM +0100, Bastien wrote:
>>>> Hi Terry,
>>>> 
>>>> tftorrey@tftorrey.com (T.F. Torrey) writes:
>>>> 
>>>> > I'm not experienced with markdown, but this doesn't look right to
>>>> > me.
>>>> 
>>>
>>>> AFAIK there is no syntax for underlining in Markdown, so underlined
>>>> text in Org will be exported as plain text in Markdown.
>>>
>>> I would argue that underlining is a form of emphasis, so the leading
>>> and trailing underscores should be passed through verbatim to
>>> markdown (which, in markdown syntax is an emphasized span).
>>
>> Yes, I see your point -- it's now the case.
>
> AFAIU, one Markdown feature is to accept raw HTML as part of the syntax.
> So, what's wrong in writing in HTML code anything that is not directly
> supported by Markdown syntax (like tables)?
>

Pandoc supports tables in markdown documents, maybe this would be a good
syntax to target, as with pandoc markdown may be further exported to
either HTML or LaTeX.

  http://johnmacfarlane.net/pandoc/README.html#tables

FWIW, it looks like pandoc also supports Org-mode tables.

  http://johnmacfarlane.net/pandoc/README.html#pipe-tables

Just throwing out ideas, I don't personally use the markdown export.

Best,

-- 
Eric Schulte
http://cs.unm.edu/~eschulte

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Rick Frankel]

On Wed, Mar 13, 2013 at 09:54:22AM -0600, Eric Schulte wrote:

> Pandoc supports tables in markdown documents, maybe this would be a good
> syntax to target, as with pandoc markdown may be further exported to
> either HTML or LaTeX.
> 
>   http://johnmacfarlane.net/pandoc/README.html#tables
> 
> FWIW, it looks like pandoc also supports Org-mode tables.
> 
>   http://johnmacfarlane.net/pandoc/README.html#pipe-tables
> 

There is a fairly standard set of extensions to the markdown syntax
called Markdown Extra, based on the extensions made for php:

      http://michelf.ca/projects/php-markdown/extra/

however, a number of markdown processors support it, including 

      multimarkdown: http://fletcherpenney.net/multimarkdown/

A couple of ruby processing libraries:

  http://kramdown.rubyforge.org/syntax.html
  http://maruku.rubyforge.org/maruku.html

Kramdown also support org table format.

and python: http://pythonhosted.org/Markdown/extensions/extra.html

I have used both ruby libraries extensively. It would be nice for the
markdown exporter to allow using the standard markdown extensions
(perhaps with a switch).

rick

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Nicolas Goaziou]

Hello,

Rick Frankel <rick@rickster.com> writes:

> On Wed, Mar 13, 2013 at 09:54:22AM -0600, Eric Schulte wrote:
>
>> Pandoc supports tables in markdown documents, maybe this would be a good
>> syntax to target, as with pandoc markdown may be further exported to
>> either HTML or LaTeX.
>> 
>>   http://johnmacfarlane.net/pandoc/README.html#tables
>> 
>> FWIW, it looks like pandoc also supports Org-mode tables.
>> 
>>   http://johnmacfarlane.net/pandoc/README.html#pipe-tables
>> 
>
> There is a fairly standard set of extensions to the markdown syntax
> called Markdown Extra, based on the extensions made for php:
>
>       http://michelf.ca/projects/php-markdown/extra/
>
> however, a number of markdown processors support it, including 
>
>       multimarkdown: http://fletcherpenney.net/multimarkdown/
>
> A couple of ruby processing libraries:
>
>   http://kramdown.rubyforge.org/syntax.html
>   http://maruku.rubyforge.org/maruku.html
>
> Kramdown also support org table format.
>
> and python: http://pythonhosted.org/Markdown/extensions/extra.html
>
> I have used both ruby libraries extensively. It would be nice for the
> markdown exporter to allow using the standard markdown extensions
> (perhaps with a switch).

This should happen in a derived back-end. There are a few Markdown
flavours, ox-md.el is only "vanilla" Markdown.


Regards,

-- 
Nicolas Goaziou

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Rick Frankel]

On Mar 15, 2013, at 1:36 PM, Nicolas Goaziou <n.goaziou@gmail.com> wrote:

> Hello,
> 
> Rick Frankel <rick@rickster.com> writes:
> 
>> On Wed, Mar 13, 2013 at 09:54:22AM -0600, Eric Schulte wrote:
>> 
>> I have used both ruby libraries extensively. It would be nice for the
>> markdown exporter to allow using the standard markdown extensions
>> (perhaps with a switch).
> 
> This should happen in a derived back-end. There are a few Markdown
> flavours, ox-md.el is only "vanilla" Markdown.
> 
> 
Agreed. 

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Bastien]

Rick Frankel <rick@rickster.com> writes:

>> This should happen in a derived back-end. There are a few Markdown
>> flavours, ox-md.el is only "vanilla" Markdown.
>
> Agreed. 

Or maybe as a set of filters that people would grab from Worg?

It would be good to educate (power-)users about filters, this
may be a way to do it.

-- 
 Bastien

Re: [bug] [new exporter] [markdown] Underline exports as HTML

[Rick Frankel]

On Fri, Mar 15, 2013 at 09:58:40PM +0100, Bastien wrote:
> Rick Frankel <rick@rickster.com> writes:
> 
> >> This should happen in a derived back-end. There are a few Markdown
> >> flavours, ox-md.el is only "vanilla" Markdown.
> >
> > Agreed. 
> 
> Or maybe as a set of filters that people would grab from Worg?
> 
> It would be good to educate (power-)users about filters, this
> may be a way to do it.

I looked at filters for the slideshow exporters, but my understanding
is that they are passed the converted text output, so, in the case of
table conversion, the column and row separators would already have
been remove by the markdown export function.

rick