以 Markdown 撰写文稿，以 LaTeX 排版

发表于 更新于 本文字数： 786 阅读时长 ≈ 1 分钟

参考资料

简介以及基本用法

请参考 以 Markdown 撰写文稿，以 LaTeX 排版

最小实例

1
2
3
4
5
6
7
8
9
10
11
\documentclass{ctexart}
\usepackage{markdown}
\begin{document}
 \begin{markdown}

1.markdown内容顶格写
2.空行检查是否有多余的Tab缩进
3.请使用PowerShell进行编译，无法在TexStudio中的运行进行编译

 \end{markdown}
\end{document}

markdown2latex.gif

注意事项

  1. 在含有 tex 源文件的目录下使用 Powershell 对如下命令进行编译 
1
xelatex --shell-escape texname.tex
  1. 使用 markdown 宏包之后，需要在 markdown 环境中书写 markdown 内容
  2. markdown 内容做到左侧无缩进（靠左侧顶格写）
  3. 同其他普通的 tex 文档一样，可以使用定制样式的文档类或宏包

比如可以使用我们喜欢的文档类，只要将相应的 cls 文件复制到同一目录下，在导言区引用即可

1
\documentclass[cn,normal,11pt,blue]{elegantnote}

可能会出现的问题

  1. 二级列表也顶格写的话就会变成一级列表

解决办法：在二级列表的前面添加四个空格，而不是增加一个 tab 键

  1. Markdown 中含有繁体中文时，输出的 PDF 中繁体中文显示会有问题
  2. 网页中带有中文字符等特殊符号时，会自动转义导致网页链接出错

解决办法：使用短链接，比如 Github：shorter，或者 Github：short_url

  1. 图片大小渲染问题，请参考：以 Markdown 撰写文稿，以 LaTeX 排版