Markdown+Pandoc

Posted evgo

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Markdown+Pandoc相关的知识,希望对你有一定的参考价值。

? 原创文章 作者:evgo 公众号:随风前行

?

这篇文章围绕 Markdown 展开,先介绍其概念,推荐编辑器,完成基础配置;再进行拓展,文档格式转换--"One write, run everywhere";最后介绍一点小应用技巧,在微信平台使用 MD 排版,扩大适用范围。

一、简介

这两篇文章是经过我认真筛选得出,简明扼要且图文并茂。再此非常感谢作者。已联系过作者,但四个月还未回复...如若侵权必删。

[注]

  1. 注意标记符号后面是否需要空格或者回车。

  2. 编辑器内也会有语法详细介绍来帮助入门。

二、编辑器推荐

  • Typora(最推荐):无 Web 版,支持全平台。免费软件,导出 .md 、.pdf、 .html(带样式)均为免费。官网:https://www.typora.io/

  • Cmd Markdown:有 Web版,支持全平台。可免费导出的只有 .md 和不带样式的 html 格式。需注册账户,部分功能付费。官网:https://www.zybuluo.com/mdeditor

  • 马克飞象:有 Web版,无 Linux 版本,有chrome插件,直接链接印象笔记。付费软件,免费试用十天。官网:https://maxiang.io/ 。(小书匠web版加载过于缓慢,不推荐了)

  • Sublime Text3 等:装逼专用。Sublime Text3 + Markdown Editing (+ Evernote)。如果有需要我再详细说明方法。

[注]

  1. Web 版本:在线编辑;全平台:Windows、Mac os、Linux;

  2. Typora 可即时排版,也可选择显示代码模式;而其他几款均只有代码模式;

  3. 浏览器推荐 chrome、firefox 等等,浏览器相当于一个系统,而插件就相当于软件;

  4. 若是文章需要保存至笔记,有道云笔记可以直接编辑 MD 文档,而印象笔记需要在MD编辑器编辑完成后复制进去(如同表格模板一样),马克飞象和 Sublime 可直接上传存储(但还是不能编辑)。

  5. 其余文档转换格式均需使用 Pandoc 进行转换。

三、Pandoc

这款软件可实现不同标记语言的格式转换,转换格式(md、doxc、epub、LaTex等等)均可使用。更多文档格式可搜索。产品官网介绍的很详细,但掌握不易,我经过一些使用与研究,对于 window 的核心使用方法简化如下:

  1. 获得 pandoc.exe 与 pandoc-citeproc.exe 文件(关键字 "pandoc" 获取文件,或在官网http://pandoc.org/installing.html下载);

  2. 将上述文件和需要转换的文件置于同一文件夹=> shift+右键 => 在此处打开命令窗口;

  3. 输入下列命令行即可。

pandoc xx.xx -o xx.xx   // 输入文件名称和后缀名,-o 意思为 out 输出
技术分享图片

[注]

  1. Markdown 文件后缀为 md。

  2. 输出文件名和格式自拟。

  3. Pandoc 在 pdf 方面有缺陷,但 Typora 可直接将 md 转换为 pdf 格式,有时间再介绍各个格式与pdf 格式之间的转换。

四、在微信文章中使用 Markdown 排版

编辑公众号文章时,可以直接导入 md 文章:

  1. chrome 浏览器安装 Markdown here 插件;

  2. 将编辑好的 md 文章复制至微信后台编辑器;

  3. 按下 ctrl+alt+m 或者插件图标即可。

[注]

  1. 某些插件会对 Markdown here 渲染产生阻碍,禁用插件即可正常渲染;

  2. md 文章需带标记符号,Typora 用户在选择栏选择 " View "=>" Source Code Mode ",再进行复制(其余MD编辑器不需要,直接复制就好)。

  3. 这篇文章就是这么做的。

五、最后

之后还有什么技巧,我会补充。如果有什么问题,留言或者联系我。

 

我的公众号(随风前行,或搜索 evgo2017),欢迎大家关注。

技术分享图片



以上是关于Markdown+Pandoc的主要内容,如果未能解决你的问题,请参考以下文章

使用 pandoc 进行文档转换(markdown转word)

如何使用 pandoc 引用 markdown 中的图形?

从 Markdown 到 PDF:如何使用 Pandoc 更改字体大小?

markdown文本转换word,pdf

Markdown+Pandoc

markdown转docx用pandoc