1. 问题描述

用过markdown的朋友都知道，markdown语法简洁，写作效率极高，非常适合网络博客、邮件、笔记等非正式文档的写作。但对于格式复杂的正式报告、论文、项目计划书等正式文档是不适合的，无法满足精细排版的要求。

解决这一矛盾的基本思路是，在markdown中写作完成初稿，之后在word中进行精细化排版设置。这就需要markdown转换word。以前一直没有找到合适的工具，今天终于发现了一个理想的工具：Writage。

2. 技术背景

Writage是一款word插件，下载网址为：http://www.writage.com/。

• 功能：支持markdown与word互相转换
• 安装：
  • Writage，word插件
  • Pandoc，文档转换后台软件

实际上实现文档格式转换的是pandoc软件，Writage作为word插件，将pandoc的功能集成到了word选项中，避免了繁琐的cmd 命令操作。

3. 解决方案

安装Writage和Pandoc软件后，word中不会直接出现选项卡，但在【打开】和【保存】的对话框中会出现相关的选项，如下：

3.1 markdown转换word

• 通过word软件打开markdown文件实现：

  
• 打开原markdown文档后，另存为word格式即可；

3.1 word转换markdown

• 首先设置word文档中的标准样式，如一级、二级标题等，如此才能与markdown的格式对应；

• word格式另存为markdown；

  

4. 实施示例

4.1 插件安装

• 下载软件：http://www.writage.com/
  
• 分别安装软件，全部按照默认安装即可
• 重启电脑

4.2 markdown转换word

• 创建markdown文档，可以在任意编辑器，如cmd markdown

  
• 导出markdown文本文档
• word软件打开markdown
  

• word中markdown文档的预览效果如下
  由于markdown中的图片无法设置大小，因此在word中排布的图片格式不标准，需要人工调整。其他格式，如一级、二级标题，项目列表等基本没有问题。

  
• 调整格式后，即可保存为word、pdf等格式

4.3 word转换markdown

直接另存为markdown格式即可：

各级标题的设置，实际上在markdown编辑器中更方便修改设置。

5. 常见问题

markdown转换word的过程中，尤其需要注意的问题是：图片的下载和存储。

5.1 markdown转换word

在原生的markdown文档中，图片以网络超链接的形式保存：

![](http://upload-images.jianshu.io/upload_images/845620-98a1261689d63d17.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

以上的网址即为图片的网络路径，如果markdown文档中有这一类图片，那么需要在网络连接的情况下，才能正常输出有图片的word文档。否则，图片处显示空白。

5.2 word转换markdown

word转换markdown之后，文档中的图片输出到本地文件夹media下：

![](http://upload-images.jianshu.io/upload_images/845620-8a1294d3c92ae632.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

文件夹与输出的markdown文档在同一目录下:

在markdown中图片引用本地相对路径：

！[](media/3dd1ad6de3e0a437694573143f0c8944.png)

故必须保证markdown与media文件夹在一起，才能完整的在markdown编辑器中显示图片。

本文用时 35 m