自分でドキュメントを書くときの記法をkramdownに統一しようと考えています(MediaWikiに慣れていますが、表やcross referenceが大変なので、そろそろ潮時かと思っています。Yamadaくんのオススメでrestructured textも考えましたが、syntaxが不自然なのでぼくは受け入れられませんでした)

インストール

Homebrewで簡単にインストールできます。kramdownという実行形式がインストールされるので、これにMarkdown形式のテキストファイルを与えて実行するとHTMLテキストが出力されます。

1
brew install kramdown

記法 - Syntax

kramdownはMarkdownのsupersetなので、基本的なMarkdown記法が使えます。 kramdown Syntaxのページには、kramdownの拡張期法も含めた文法の説明があります。基本的にはメールにプレインテキストでちょっと長い文章を書くときにみんなやっているようなフォーマッティングと似ています(とくに箇条書きや強調)。

画像の縮小表示

それで、試しに今勉強している分野の論文のまとめを作っていたら、画像を縮小して貼り込みたいというリクエストが出ました。結論から書くと、

{: style=”width: 200px; vertical-align:middle;”}

みたいにすると出来るようです(HTMLに変換する場合)。

以下は、箇条書きの中で使ったときの例：

``
### Burgess & Summers 1969
-   density dependent dielectronic recombination
-   *detailed description on density dependence of dielectronic
    recombination*
-   <http://adsabs.harvard.edu/abs/1969ApJ...157.1007B>
-   Papers/Burgess and Summers 1969.pdf
-   ![image](Images/Burgess%20and%20Summers%201969%20Figure%201.png){: style="width: 200px; vertical-align:middle;"}

markdown summary.md > summary.html; open summary.htmlとしてHTMLに変換してSafariで表示すると、以下のようになりました。

HTMLとしては以下のようなものが生成されています。