reStructured Text で HTML を直接書く

reST や Markdown といった軽量マークアップ言語は HTML を手書きしなくてもよい(= シンプルなマークアップで HTML に変換してくれる)ところが利点ですが、それでも文書を書いているときに HTML をそのまま書きたいこともあります。

例えば、Amazon などの商品リンクを載せようと思ったら amazlet などを利用して(Amazon 純正でもいいですけれど)紹介用の HTML タグを取得することが多いと思います。それを reST ファイルの中で利用するにはどうしたらよいのでしょうか。

調べたところ、raw ディレクティブ(.. のあとに続けて書くアレ)を使えばいいそうです。

.. raw:: html

   <iframe width="560" height="315" src="//www.youtube.com/embed/-x640lbMucc" frameborder="0" allowfullscreen></iframe>

これで OK です!