跳到主要内容

Markdown + Pandoc

阅读需 4 分钟

这篇文章围绕 Markdown 展开,先介绍其基础概念和推荐的编辑器;再进行拓展:文档格式转换器Pandoc—“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. 这篇公众号文章就是这么做的。

五、最后

之后还有什么技巧,我会补充。

如果有什么问题,留言或者联系我。

微信号、公众号:evenIfAlsoGo

文章为本人原创,如需转载请联系我,谢谢。

暂时未加入评论功能,请在对应公众号文章下或 GitHub Issues下留言反馈。