Misakaを使ってPythonでMarkDownをHTMLに変換する

MarkDownをHTML形式に変換して、htmlファイルとして利用したいことがあるかもしれません。今回は、そのための便利ツールであるmiaskaについて紹介いたします。

また、MarkDownファイルを読み込んで、HTML形式に変換してファイル出力するコードも添付しています。是非、お使いください

[box02 title="この記事のINDEX"]

misakaの基本的な使いかた
misakaでMarkDownファイルをHTMLファイルに変換してみる

[/box02]

misakaの基本的な使い方

まずは、misakaをインストールしましょう。misakaのインストールは簡単で以下のようにpipコマンドを利用します。

pip install misaka

misakaでMarkDownをhtmlに変化する方法は２つあります。それぞれ見ていきましょう。

# misaka利用方法(1つ目)

import misaka as m


markdown_text = 'Hello World'
print(m.html(markdown_text))
# <p>Hello World</p>

markdown_text = '# Hello World'
print(m.html(markdown_text))
# <h1>Hello World</h1>

上のように、misaka.html(マークダウン文字列)とすることで、マークダウン文字列がHTMLに変換されます。

また、以下の方法もあります。

# misaka利用方法(2つ目)

from misaka import Markdown, HtmlRenderer

rndr = HtmlRenderer()
md = Markdown(rndr)
markdown_text = 'Hello World'
print(md(markdown_text))
# <p>Hello World</p>


markdown_text = '# Hello World'
print(md(markdown_text))
# <h1>Hello World</h1>

misakaでMarkDownファイルをHTMLファイルに変換してみる

次に、misakaを利用して、markdown形式で記述したファイルを読み込んで、html形式に変換して保存するコードを書きました。是非、ご利用ください

from misaka import Markdown, HtmlRenderer

rndr = HtmlRenderer()
md = Markdown(rndr)
html_lines = []

# markdown_input.mdというマークダウン形式のファイルを同一ディレクトリに配置
with open('markdown_input.md', 'r', encoding='utf-8') as fs:
    html_lines.append(md(fs.read()))

# html_output.htmlというファイルにhtml化したファイルを出力
with open('html_output.html', 'w', encoding='utf-8') as fs:
    for line in html_lines:
        fs.writelines(line)

ちなみに、MarkDown=>HTMLに変換した結果以下のように表示されました。

ほぼ、完璧に変換されているのでは、ないでしょうか？

(サンプルコードはこちらから使わせていただきました。)