[Tex/LaTex] Latex & Markdown files

luatexmarkdown

I am writing my project docs in latex but I have a bunch of markdown (.md) files to include as chapters. I have a problem when latex parses the md files it reads all the tables and figures as plane text but does not render the tables nor the images.
My environment is Mac OSX Mojave using MacTex-20180417, my editor is TexMaker with the LuaLatex engine.
My file looks like:

\usepackage[blankBeforeHeading, html, fencedCode, 
            inlineFootnotes, citations, definitionLists, 
            hashEnumerators, smartEllipses, hybrid]{markdown}

\begin{document}

\markdownInput{myfile.md}

\end{document}

myfile.md includes a basic table and a figure but the pdf output only displays the raw data. eg: |this|is|my|table|.

My question is: Is there anything else I have to setup or any package to inlude in order to render the table and the figure?

i add a minimal example I made here

Best Answer

You have to use the option pipeTables:

\documentclass{article}
\usepackage[blankBeforeHeading, html, fencedCode,
            inlineFootnotes, citations, definitionLists,
            hashEnumerators, smartEllipses, hybrid, pipeTables]{markdown}

\usepackage{filecontents}
\begin{filecontents*}{\jobname.md}
This file is generated as a test for tables:

| Version | Date        |Paragraph| Description       | Author|
|:--------|:------------|---------|:------------------|-------|
| 1.0     | 12/Abril/19 | All     | initial commit    | RACG  |
| 1.0     | 12/Abril/19 | All     | initial commit    | RACG  |

\end{filecontents*}

\begin{document}
  \markdownInput{\jobname.md}
\end{document}

Related Solutions

[Tex/LaTex] Converting Markdown to LaTeX, in LaTeX

A proper markdown parser is a task too complex for latex. Not because TeX is not a Turing complete language (it is), but because it would be very difficult to implement, and probably will have a very poor performance.

One idea which immediately comes to mind is to use LuaTeX, and code the markdown parser in Lua language. This sound certainly feasible.

According with Wikipedia, there are only three Markdown parsers implemented in Lua:

markdown.lua. It is simple, and it would be probably easy to integrate into a LuaLatex package, but currently it only outputs HTML, so a complete rewrite of the output part should be done to generate latex code instead.
lunamark. This is very complete. It can output a variety of formats, including LaTeX, and supports a lot of non-standard extra modules. However, it has a number of dependencies of other Lua packages, so in order to integrate it with LuaTex it should be stripped down (for example, template support could be removed, since the template will be the document which uses it, and also all output formats except LaTeX).
lua-discount This is a lua binding to a parser written in C, so it can be discarded because that would not be embeddable in LuaTeX.

So the Lua approach basically reduces to one of those two:

Change markdown.lua to make it output LaTeX
Strip down lunamark to remove all unnecessary stuff.

I'm not sure which one will be easier. Probably 1 will produce some useable in a shorter time, but 2 looks like a better long term solution.

Also, the interface between LaTeX and Lua should be defined. A sensible approach would be:

% Latex stuff....
\begin{markdown}
# First section
etc..
\end{markdown}

However I'm very new to the LuaTeX world, and (currently) I don't know how to pass to a Lua function all the text inside the markdown environment. Also we should prevent TeX to tokenise all that text.

A possible idea is to use some verbatim-like tricks to write the contents of the environment to a file, and then use lua to process that file and insert back the resulting tex in the main document (a tex.sprint() would do, wouldn't?)

I would like to hear the opinion of the LuaTeX experts here...

PS: Does this count as an answer? Or should I delete it and re-post as a question instead?

[Tex/LaTex] LaTeX to Markdown converter

Pandoc is what you need. This tool helps you convert any markup format to another one including from latex to markdown.

For your need, first you need to install pandoc into your system (available for all MacOS, Windows, Linux) and then use this command line

pandoc -s example4.tex -o example5.md

You can also convert your texts online by using a tool provided here.

Best Answer

Related Solutions

[Tex/LaTex] Converting Markdown to LaTeX, in LaTeX

[Tex/LaTex] LaTeX to Markdown converter

Related Question