このセクションでは、多くのMarkdownを作成するために必要な特別要件を与えるため、「Markdownでテキストを良くする」というタイトルのセクションにおける基本的な情報を発展させます。分からない場合や、下記に記載されているフォーマットを必要としない場合は、このセクションを読み飛ばして、必要な時に再度お読みください。

• 改行
• 水平方向の罫線
• 画像のリンク
• 埋め込みHTML
• フォーマット済みコード
• 特殊文字の使用
• 補足情報

改行

いくつかのテキスト、例えばpoetry ( 詩、詩歌 ) や verse ( 詩、詩歌 ) では、 頻繁に改行を入れる必要があります。リターンキーで改行を試みると、意図したような効果は無く、デフォルトで段落を作るために行が一緒に動きます。

二十日鼠と人間が作った最良の方法でさえ、
しばしば思わぬところに行ってしまう、
そして私達に悲しみや苦痛を残す、
約束された楽しみのために!

上記の入力内容は、改行するためにリターンキーを使用すると、下記のように改行が無視された形になります:

二十日鼠と人間が作った最良の方法でさえ、 しばしば思わぬところに行ってしまう、 そして私達に悲しみや苦痛を残す、 約束された楽しみのために!

しかし、各行に2つのスペースを入れると、下記のように改行を行うことができます:

二十日鼠と人間が作った最良の方法でさえ、
しばしば思わぬところに行ってしまう、
そして私達に悲しみや苦痛を残す、
約束された楽しみのために!

水平方向の罫線

3つ以上のアスタリスク ( * ) 、ハイフン ( - ) または下線 ( _ ) を入力することにより、水平方向の罫線を作成することができます。

これは動作します:

***

しかし、例えばテキスト編集ウインドウで更に明確にセクションブレークを行うために、空白または更なる文字を追加することができます。

* * * * *

-------------------------

_ _ _ _ _

これら全ての方法では正確に同様の結果となります:

---

画像のリンク

Markdownドキュメントでテキストを強化することにより、ウェブリンクを作成したり、画像を挿入することができます。既にクリックできるリンクのある画像を挿入することができない場合もあります。

[the google search engine][google]

![the google logo][logo]

上記は標準的なウェブリンクとイメージです。リンクテキストがある場所に画像をこのように置くこともできます:

[![the google logo][logo]][google]

上記のリンクでは、文書内の他の場所にある下記のようなリンク定義と連携したものです:

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "click to visit Google.com"

下記のようなクリッカブル画像リンクを作成してください ( リンクにホバーしたい場合は、ツールチップを同時に作成してください ):

このテクニックの便利な例は、大きな写真をダウンロードするために、小さな「サムネイル」をリンクとして設置するという例です。

埋め込みHTML

既にHTMLに関して熟練していると、Markdownはあなたが慣れているような十分なコントロールを許さない場合もあります。幸いにも、Markdownは、この事態に対処するために設計されており、Markdownフォーマットテキストに直接HTMLを埋め込むことができます。

* <small>小さなテキスト</small>
* <big>大きなテキスト</big>

• 小さなテキスト
• 大きなテキスト

HTMLマークアップは、弾丸リストと共存していますので注意してください。これは、特定の状況であなたに完全なHTMLにアクセスすることを許可する、段落やリストのような基本的なフォーマット機能のような複雑なHTMLを記述する平凡な仕事からあなたを解放します。

フォーマット済みコード

上記のセクションと異なり、HTMLとして処理されるよりも、あなたが入力した通りにHTMLを表示したい場合、それぞれの行を4つの空白文字で開始することができます。

<p>コードとして表示される <b>HTML</b> 内の段落</p>

これもまた、コンピュータコードを表示することができます:

print "Command-line arguments: (@ARGV)\n";

このフォーマットは、しばしばコンピュータプログラムのリスト、またMarkdownが異なるタイプのフォーマットを表示するうために使用する文字を含む他のテキストに使用されます。これらの行では、Markdownのフォーマットは解除されます:

通常、この単語は **太字** です。

通常のテキストにこのような文字を含む方法については、下記のセクションをご覧ください。

特殊文字の使用

Markdownフォーマット無しで、特殊文字を使用して処理したい場合は、単純に逆スラッシュ文字 ( \ ) を文字の前に記述してください。これは文字の「エスケーピング」として知られています。バックスラッシュは表示されませんが、バックスラッシュに続く文字は、即座に入力した内容通りに表示されます。

\*強調では無く、アスタリスク\*

は次のように表示されます。

*強調では無く、アスタリスク*

逆に下記の場合は、

*強調では無く、アスタリスク*

次のように表示されます。

強調では無く、アスタリスク

補足情報

MarkdownシステムはMoodle独自のものでは無く、増え続けるウェブパブリッシングのツールとして使用されています。Markdownシステムに関する詳細情報は、http://daringfireball.net/projects/markdown/ でご覧頂けます。