Struggling to find information on LaTeX sections -> Markdown directives

[dmca-glasgow]

Hi there, I'm new to Pandoc!

I'm struggling to find more information on how Pandoc converts LaTeX's \begin{name} ... \end{name} sections to Markdown "directives".

I have the following LaTeX:

\begin{example}
Test example
\end{example}

\begin{definition}
Test definition
\end{definition}

\begin{task}
Test task
  \begin{answer}
  Test answer
  \end{answer}
\end{task}

When running the command:

pandoc --output test.md test.tex

The resulting Markdown looks like this:

::: example
Test example
:::

::: definition
Test definition
:::

::: task
Test task

::: answer
Test answer
:::
:::

Which is almost ideal for my usecase, with one exception: my existing Markdown to HTML conversion tool uses micromark-extension-directive which has a different rule for nesting (search their readme for "nest" to see their example). Its syntax requires outer directives to increment preceding colons, for example:

:::: task
Test task

::: answer
Test answer
:::
::::

I had a look at creating a Lua filter for this, but I'm struggling to find the right Pandoc term for this structure.

Also, I don't need to support the nesting logic at this stage, I think I can get away with a special case for task, for example:

if (name === 'task')
   output 4 colons
else
  output 3 colons

Any pointers? Thanks.

[jgm]

It wouldn't hurt for us to increase the length of the colons depending on nesting. (Our syntax doesn't require this, but it permits it.) So that's probably a decent change to consider, especially if it aids compatibility.

[jgm]

Go ahead and submit an issue for this (targeting the markdown writer).

[dmca-glasgow]

Will do, thanks

[dmca-glasgow]

Done: #9450