当我收到一个 Markdown 文件时,我可以在 Markdown 编辑器中打开它,例如 Linux 上的 React 或 Windows 上的 Markdown Monster 等。但是 - 这些编辑器不支持将 Markdown 中嵌入的 LaTeX 渲染为内联数学(即带有单美元符号) - 而我面临着渲染此类文档的任务。
显然,一些基于 Web 的系统支持此功能 - 比如 TeX.SX 上的系统。但我在带有命令 shell 的终端中;或者可能正在编写脚本来执行此操作。我在 Linux 系统上。
渲染的输出格式应为 PDF、带有 MathML 的 HTML、带有渲染图像的 HTML 或任何其他合理的格式。最好我能够在这些输出类型选项中进行选择。
答案1
如果你需要一个命令行工具来将 markdown 转换为 pdf 或 html,那么它pandoc
可能是一个不错的选择。你只需调用:
$ pandoc infile.md -o outfile.pdf
或者
$ pandoc infile.md -o outfile.html
以生成所需的输出。
如果需要,您可以配置该过程。对于 html 中的数学运算,您可以选择不同的渲染选项,例如--mathjax
或--mathml
。如果您需要嵌入图片,请使用--webtex
。这些都记录在手册中:https://pandoc.org/MANUAL.html#math-rendering-in-html
答案2
你应该考虑使用工作室和 Rmarkdown。支持内联 LaTeX 数学预览,也可以pandoc
在后台使用 LaTeX 将其导出为 PDF,或者导出为 HTML 甚至 Word。
答案3
渲染是个好主意,pandoc 是我的选择。但如果只是显示问题,你也可以考虑泰波拉
Typora 是目前我首选的 markdown 编辑器。它可以将 markdown 实时渲染到文档中。这使得编辑变得非常容易,因为有直接的视觉反馈,无论 markdown 语法是否正确 ;-)。如果语法不正确,它将不会按预期呈现。所有这些都在一个窗口中处理,而不是像其他编辑器那样在并排视图中处理。因此,文本在 markdown 语法和渲染输出之间切换。有些人不喜欢这样。但在我看来,Typora 很好地解决了这个问题。但这个问题最重要的部分是:它还支持 LaTeX-Equations 和美人鱼-图表。
Typora 还支持 PDF 导出和与 pandoc 的集成。
此外,我喜欢该程序的简约外观。
另一个选择是泽特尔,不久前我也测试过它,同时还测试了 Typora。最后我选择了 Typora。Zettlr 具有类似的功能。但我不太了解它们,也不想详细介绍。我只能说,我的一位同事对 zettlr 非常满意。
编辑:由于 Typora 已成为付费应用,我还测试了一些具有类似功能的其他应用。目前我决定使用标记文本,它还具有渲染 LaTeX 内联数学运算的所需功能。
答案4
如果您想使用 MathJax(最常见的解决方案),您只需配置您的 markdown 处理器以保持数学不变,但<script>
在页面头中添加一个元素。
所以如果你从 markdown 开始
# test
some text \(\frac{x}{y}=z^2\)
生成 HTML
<!DOCTYPE html>
<html>
<head>
<title>test</title>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
</head>
<body>
<h1>test</h1>
<p> test \(\frac{x}{y}=z^2\)</p>
</body>
</html>
渲染结果为