Word怎么转换Markdown

一、自动转换Markdown

    很多时候不需要手动编写Markdown文件，目前有两种方式可以将word转化为Markdown格式。

1、在线转换：Word to Markdown Converter

点击选择文件 > 选择对应需要转换的文件 > 点击convert

2、使用office插件转换

下载：writage

下载：Pandoc

安装好插件后，使用office打开相应文档，在另存为处会新增Markdown文件格式。

二、Markdown运行及打包

    这里使用的是Python的插件mkdocs来运行打包的。mkdocs插件说明: 一款python的插件，可以通过解析markdown语法的md文件快速生成静态页面，常用于搭建个人博客或者创建项目在线文档。
中文文档：mkdocs

1、首先下载python，并且配置好环境变量

今天配置后一直不起效果，最后在系统变量的path中也增加了配置才有效果。

2、安装相关依赖

pip install mkdocs

3、创建项目

mkdocs new my-project

custom_theme是自定义主题;
docs文件夹里是md文件，会根据这个目录下的md文件生成html；
site是打包后的静态资源，发布时只需要部署这个文件夹就可以了；
.yml是配置文件。

4、运行服务

在项目根目录下执行语句：

mkdocs serve

    今天在这里也出现了问题，最后查询得知。首先要将图片资源文件夹名改为img，再将转换好的.md文件中的图片路径更改为/img/…

5、打包

运行代码语句：

mkdocs build

执行该命令后默认(可配置)会在项目根目录下生成site文件夹。