java markdown转word_Markdown 格式如何转换成 Word？

1. 问题描述

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

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

2. 技术背景

功能：支持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 插件安装

创建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中图片引用本地相对路径：


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

​