読者です 読者をやめる 読者になる 読者になる

はてなブログのMarkdown記法の使い方

はてなブログ
スポンサーリンク

はてな記法でブログを始めましたが、なぜかpre記法が効きません…。
設定もはてな記法モードになってるし、いくら調べても解決策が見つからなかったので直接<pre></pre>と記載して強引にやっていたんですが、HTMLタグが入ってくるとHTMLで認識されてしまうようなので諦めて、一応エンジニアなのでMarkdown記法を試してみることにしました。使い方をまとめていきます。

見出し記法

見出し記法にはAtx形式とSetext形式の2種類あります。

Atx形式

見出しの先頭に#を記述します。#は1~6個まで対応。
また、末尾の#は編集中に目立つように記載するもので表示はされません。

#Atx形式見出し1
##Atx形式見出し2###########
…
######Atx形式見出し6
Setex形式

見出しの次の行に等号「=」とハイフン「-」を記述します。「=」と「-」の数は問いませんが、「=」がAtx形式の#1つ、「-」がAtx形式の#2つと同じで、Setex形式は2レベルまでしかありません。

Setex形式見出し1
==========
Setex形式見出し2
-

強調記法

**または__で文字の前後を囲むと太字になり、*または_で囲むと斜体となります。両方組み合わせると太字かつ斜体です。

**太字で表示**で__こっちも太字__   
*斜体で表示*で_こっちも斜体_
***太字かつ斜体***で___太字かつ斜体___

太字で表示こっちも太字
斜体で表示こっちも斜体
太字かつ斜体太字かつ斜体

code記法

この記事でも何回か使用してますが、文章中のコードを表示したい時に`<div>`のような形でバック・クォートで囲むと使えます。意外と便利。バック・クォートを表示させるには「`」を2つと半角スペースで囲みます。

pre記法

コードブロックのシンタックスハイライトに対応しているので下記のように ```で表示範囲の前後に記述するとHTMLなどのソースコードを整形済みテキストとしてそのまま表示できます。java,javascript,perl等、他にも言語の指定が可能です。

 ```ruby
 require 'redcarpet'
 markdown = Redcarpet.new("Hello World!")
 puts markdown.to_html
 ```
 require 'redcarpet'
 markdown = Redcarpet.new("Hello World!")
 puts markdown.to_html

引用記法

一行目の行頭に>を記述します。それだけ。このままだと改行してもずっと引用文になってしまうので、終わりたければ一行空白で改行します。

>引用文です。
ここも引用文です。

ここは引用文ではありません。

リンク記法

リンク記法には自動/直接/参照リンクの3種類あります。

自動リンク記法

一番シンプル。< URL >で囲むだけです。

直接リンク記法

「[表示する文字](URL)」という書式で、文章中にリンクを埋め込むことができます。また「[表示する文字](URL "リンクのツールチップ文字列")」という書式も可能です。

[はてなポータルサイト](http://www.hatena.ne.jp/)がオススメです。
[はてなポータルサイト](http://www.hatena.ne.jp/ "はてながあればネットがさらに便利に。")がオススメです。
参照リンク記法

文章中のリンクの参照先URLを文末等の別の場所で定義する方法です。ブログの表示は変わらないけど編集画面でスッキリしますね。文章中に埋め込むリンクは、「[リンクする文字列][ID]」の書式で、リンクの定義は文章の任意の箇所で「[ID]: URL "リンクのツールチップ文字列"」というような書式です。同じリンク先が複数あったりすると便利かもしれません。IDは半角英数字、全角も可能です。

- [はてなポータルサイト][1Linkリンク]

記事の本文。

※記事の下の方でまとめてリンクを定義  
[1Linkリンク]: http://www.hatena.ne.jp/

表組み記法

一行目がヘッダ、二行目にヘッダとデータの区切りを-で入力し:の位置で左寄せ、センタリング、右寄せを指定します。三行目にデータを入力です。左右の||は省略可能で、表の上下に空行が必要になります。表の中に改行を入れたい場合は<br>を使用しましょう。

|名前|性別|居住地|
|:---|:---:|---:|
|山田 太郎|男|北海道札幌市|
|佐藤 花子|女|東京都港区|
|鈴木 一郎<br>鈴木 優子|男<br>女|鳥取県鳥取市|
名前 性別 居住地
山田 太郎 北海道札幌市
佐藤 花子 東京都港区
鈴木 一郎
鈴木 優子

鳥取県鳥取市