Markdown文件导出为HTML的小程序

为什么做

最近把一些学习经验记下来，总结成MarkDown文件，不知不觉已经有12篇了。

Sublime Text 的 MarkDown Preview 插件能够将MarkDown语法转换为HTML，并提供三种预览方式：浏览器预览、保存为HTML文件、输出到Sublime的新标签页。

但有一个缺点是，我有12个MarkDown文件，想分别转换为HTML文件，需要重复执行12次打开文件->Crtl＋P调出命令面板->输入MarkDown Preview->选择Save To HTML->选择保存路径->确定。

我突发奇想，Sublime是基于Python的，何不利用MarkDown Preview的API，写一个Python脚本，进行批量转换。这样，无论是12篇，还是120篇，都可以通过一个命令轻松完成转换，避免了重复劳动。

怎么做的

我通过Sublime的Preferences->Browse Packages找到了一个名为python-markdwon的文件夹，似乎是用来支持MarkDown转换的。

阅读了其中的__init__.py文件，了解到这个包可以将MarkDown转换为HTML。它提供了两个API：

• html = markdown.markdown(your_text_string)

• html = markdown.markdownFromFile(file_name)

如此简单易用，就是它了！

经过测试，markdown.markdownFromFile()这个函数对中文支持较差：如果文件内容含有汉字，转换后的html字符串出现奇怪的乱码。似乎可以提供附加参数指定编码格式，但我决定不去偷这个懒（好吧，其实是懒得去研究源代码）。

设计思路很简单:

• 在指定文件夹内读取所有.md文件：

    for x in os.listdir('.／input'): 
        if os.path.splitext(x)[1]=='.md':
            ...

• 对每个.md文件，其内容是一个字符串

    with open('/path/file_name.md', 'r') as f:
        md = f.read()

• 利用markdown.markdown()转换为HTML格式对字符串

    html = markdown.markdown(md)

• 将HTML格式字符串写入到.html文件内

    with open('/path/file_name.html', 'w') as f:
       f.write(html)

当然，其中还要考虑路径、字符编码等问题。这里并没有列出，详细代码可参看下文。

怎么用

我建立了这样的文件结构：

 .
 |---markdown
 |
 |---input
 |   |---1.md
 |   |---2.md
 |
 |---output
 |   |---1.html
 |   |---2.html
 |
 |---run.py
 |
 |---empty_output.py

• markdown文件夹是从Sublime插件目录的python-markdown直接复制过来的。

• input文件夹内放的是转换前的MarkDown文件，目前只支持英文文件名。

• output文件夹里是自动生产的转换后的HTML文件，与对应的MarkDown文件同名。

• run.py是执行的脚本文件，用来将MarkDown转换为HTML。

• empty_output.py用来清空output文件夹的内容，但不删除该文件夹。

运行步骤很简单：

• 将MarkDown文件通通放入input文件夹下

• 命令行执行python run.py

• 去output文件夹下找转换后的文件

为什么只支持英文文件名呢？这个问题我也想解决，搜了一些博客，在MacOS下测试中文文件名都一切OK。但是换到了Windows下就翻脸不认人。还是我Python道行太浅，索性就只支持英文文件名吧。

做出了什么

这里贴一下run.py和empty_output.py的代码。最核心的转换算法python-markdown可以在GitHub上搜到。

整个程序的源码可以在这里得到。

run.py

    import os
    import markdown
    import codecs
    import sys
    
    reload(sys)
    sys.setdefaultencoding('utf-8')
    
    input_dir = './input'
    ouput_dir = './output'
    input_file_type = '.md'
    ouput_file_type = '.html'
    
    print '\n'
    for full_input_file_name in os.listdir(input_dir):
        if os.path.splitext(full_input_file_name)[1]==input_file_type:
                
            print 'Converting ' + full_input_file_name + ' ...'
    
            file_name = os.path.splitext(full_input_file_name)[0]
            full_input_file_name = input_dir + '/' + full_input_file_name
            full_ouput_file_name = ouput_dir + '/' + file_name + ouput_file_type
    
            with codecs.open(full_input_file_name, 'r') as ifile:
                in_file_content = ifile.read()
                ou_file_content = markdown.markdown(in_file_content)
    
                with codecs.open(full_ouput_file_name, 'w', 'gbk') as ofile:
                    ofile.write(ou_file_content)
        
    print '\nAll Done!'

empty_output.py

    import os
    import markdown
    import codecs
    import sys
    
    reload(sys)
    sys.setdefaultencoding('utf-8')
    
    ouput_dir = './output'
    
    print '\n'
    for file_name in os.listdir(ouput_dir):
        print 'Deleting ' + file_name + ' ...'
    
        full_file_name = ouput_dir + '/' + file_name
        os.remove(full_file_name)
        
    print '\nAll Done!'