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文档中，图片以网络超链接的形式保存：
以上的网址即为图片的网络路径，如果markdown文档中有这一类图片，那么需要在网络连接的情况下，才能正常输出有图片的word文档。否则，图片处显示空白。
5.2 word转换markdown
word转换markdown之后，文档中的图片输出到本地文件夹media下：
文件夹与输出的markdown文档在同一目录下:
在markdown中图片引用本地相对路径：
！[](media/3dd1ad6de3e0a437694573143f0c8944.png)
故必须保证markdown与media文件夹在一起，才能完整的在markdown编辑器中显示图片。
本文用时 35 m