list format via enumitem

[lululxvi]

I am using enumitem to format my lists: compact and small leftmargin (\setlist{leftmargin=1.25em, nosep}). But this doesn't work for lists defined in markdown. As mentioned in #2, markdown uses paralist compactitem to render lists, is this right? Is it possible to use enumitem for lists defiend in markdown? Thanks.

Another question: how can I use hyperref for links?

[Witiko]

I am using enumitem to format my lists: compact and small leftmargin (\setlist{leftmargin=1.25em, nosep}). But this doesn't work for lists defined in markdown. As mentioned in #2, markdown uses paralist compactitem to render lists, is this right? Is it possible to use enumitem for lists defiend in markdown? Thanks.

The paralist package is only loaded when the tightLists option is set to true, see also Section 3.3.4 of the technical documentation:

If the \markdownOptionTightLists macro expands to false, do not load the paralist package. This is necessary for LaTeX2ε document classes that do not play nice with paralist, such as beamer. […]

Therefore, the easiest way out for you should be the following:

\markdownSetup{
    tightLists = false,
}

[Witiko]

Another question: how can I use hyperref for links?

One possible way would using the link renderer:

\markdownSetup{
    renderers = {
        link = {\href{#3}{#1}},
    },
}

[lululxvi]

Thank you. tightLists=false works. I have a few other questions:

• What grammar of markdown can I use? Is it pandoc? For example, how can I type textsuperscript etc?
• For the link, my previous question is not clear. For example, in latex after importing hyperref, we can use \url{google.com} to have nice color and clickable link. How can I do this for url in markdown?
• How can comment in markdown? I found that <!-- --> or pandoc style $-- does not work. Although we can use latex comment grammar %, I prefer pure markdown grammar.
• I use iftoggle from etoolbox. Even if I use \usepackage[hybrid]{markdown}, the iftoggle doesn't work in markdown. Is it as excepted?

Sorry that I have so many questions, because I like this tool, and want to use it extensively. Thank you in advance.

[Witiko]

What grammar of markdown can I use? Is it pandoc? For example, how can I type textsuperscript etc?

We support some of the Pandoc's syntax extensions, namely citations and tables. For the full list of supported syntax extensions, see Section 2.2 (Options) of the user manual.

[Witiko]

For the link, my previous question is not clear. For example, in latex after importing hyperref, we can use \url{google.com} to have nice color and clickable link. How can I do this for url in markdown?

In markdown, there are several ways of producing links:

\documentclass{article}
\usepackage{markdown}
\markdownSetup{
    renderers = {
        link = {\href{#3}{#1}},
    },
}
\usepackage{hyperref}
\begin{document}
\begin{markdown}
This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is [an example] [id] reference-style link.

[id]: http://example.com/  "Optional Title Here"

This is an automatic link: <http://example.com/>.
\end{markdown}
\end{document}

The result:

[Witiko]

How can comment in markdown? I found that <!-- --> or pandoc style $-- does not work. Although we can use latex comment grammar %, I prefer pure markdown grammar.

You can use the html option:

\usepackage[html]{markdown}
...
\begin{markdown}
This is some text <!-- and this is a comment -->
\end{markdown}

[Witiko]

I use iftoggle from etoolbox. Even if I use \usepackage[hybrid]{markdown}, the iftoggle doesn't work in markdown. Is it as excepted?

It should not be excepted. Can you give an example document that shows what doesn't work?

[lululxvi]

Thanks. iftoggle actually works. But html <sup> </sup> or pandoc ^^ doesn't work for text superscript.

[Witiko]

That's correct. HTML is currently just discarded, not rendered, although there are multiple ways in which we could extend the HTML support in the future:

1. Support rendering HTML tags such as <sup>.
2. Support passing HTML through when typesetting HTML documents using make4ht.

Pandoc's extension for superscripts (^^) is currently not supported, but it would be a straightforward addition much like strikeout (~~). I'll make this issue into a feature request and we'll see if I or some other contributor can find the time to implement these.

[TomBener]

For the link, my previous question is not clear. For example, in latex after importing hyperref, we can use \url{google.com} to have nice color and clickable link. How can I do this for url in markdown?

In markdown, there are several ways of producing links:

\documentclass{article}
\usepackage{markdown}
\markdownSetup{
    renderers = {
        link = {\href{#3}{#1}},
    },
}
\usepackage{hyperref}
\begin{document}
\begin{markdown}
This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is [an example] [id] reference-style link.

[id]: http://example.com/  "Optional Title Here"

This is an automatic link: <http://example.com/>.
\end{markdown}
\end{document}

The result:

If the option hybrid = true, the example below with special symbols reported errors:

\documentclass{article}
\usepackage{markdown}
\markdownSetup{
    hybrid = true,
    renderers = {
        link = {\href{#3}{#1}},
    },
}
\usepackage{hyperref}
\begin{document}
\begin{markdown}

A link with special symbols: <http://www.moa.gov.cn/gk/zcfg/nybgz/201111/t20111122_2414394.htm>

\end{markdown}
\end{document}

The errors info was Missing $ inserted., and the log file showed:

[]\TU/lmr/m/n/10 A link with special symbols: http://www.moa.gov.cn/gk/zcfg/nybgz/201111/t20111122$[]\OT1/cmr/m/n/10 414394\OML/cmm/m/it/10 :htm[]$ 
 []

I know a short link can be applied to fix the issue, bu how can I use both the hybrid = true and the original link with special symbols? Thank you!

[Witiko]

@TomBener Hello! Try substituting #3 with #2 in the definition of link. From the documentation (emphasis mine):

The \markdownRendererLink macro represents a hyperlink. It receives four arguments: the label, the fully escaped uri that can be directly typeset, the raw uri that can be used outside typesetting, and the title of the link.

[Witiko]

Closed for inactivity.