Markdownの高度な使い方

改行

たとえば詩や詩などのテキストでは、改行を挿入する必要があることがよくあります。デフォルトでは行が段落を作成するために一緒に実行されるため、リターンキーを使用して実行しようとしても意図した効果は得られません。

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

改行を挿入するためにenterキーを使用する上記の入力は、そのような改行が無視されるので、以下の出力を与えるでしょう。

The best laid schemes o' Mice an' Men, Gang aft agley, An' lea'e us nought but grief an' pain, For promis'd joy!

しかし、各行を2つのスペースで終わらせることで、次のように強制的に改行することができます。

'Mice an' Menのベストレイドスキーム
ギャング後方アグリー、
「私たちは無知だが悲しみを感じる」
約束の喜びのために！

水平線

水平線は、1行に3つ以上のアスタリスク（*）、ハイフン（ - ）、または下線（_）を付けることによって作成できます。

これは動作します：

***

ただし、テキスト編集ウィンドウでスペースや文字を追加して、明らかにセクション区切りにすることもできます。

* * * * *

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

_ _ _ _ _

これらの方法はすべて水平方向の規則を与えます。

テーブル

Markdownを使って簡単なHTMLテーブルを作成することができます。これが一例です。

Name    |   Age
--------|------
Fred    |   29
Jim     |   47
Harry   |   32

名	年齢
フレッド	29年
ジム	47
ハリー	32

セルの内容に通常の書式設定を適用できます。水平バーの左または右にコロンを追加することで、列を左または右に揃えることができます（追加の説明を参照）。

定義リスト

定義リストは用語とそれに続く定義から成ります。むしろ辞書のように。簡単な例は次のとおりです。

Moodle
:   A well-known online learning platform

PHP
:   A scripting language.
   Mostly used for developing interactive web applications.

ムードル

有名なオンライン学習プラットフォーム

PHP

スクリプト言語主にインタラクティブWebアプリケーションの開発に使用されます。

脚注

脚注には2つの要素があります。テキスト内のマーカーで、上付き番号となり、文書の末尾に表示される脚注定義になります。これは簡単な例です：

Read about it in my book.[^1]

[^1]: All about my book.

脚注の定義は好きな場所に配置できます。それらはテキスト内でリンクされている順にリストされます。同じ脚注に複数のリンクを張ることはできません。

HTMLを埋め込む

もしあなたがすでにHTMLに習熟しているのであれば、Markdownがあなたが慣れているほど多くのコントロールをあなたに許さない場合があるかもしれません。幸いなことに、Markdownはこのような事態のために設計されており、Markdown形式のテキスト内に直接HTMLを埋め込むことができます。

HTMLマークアップは、箇条書きリストのマークダウンコードと共存します。これにより、段落やリストなどの基本的な書式設定機能のために複雑なHTMLを記述するという面倒な作業から解放されながら、特定の状況でHTMLの全機能を利用することができます。

HTMLまたはフォーマット済みテキストの表示

HTMLとして処理するのではなく、入力したHTMLを正確に入力したとおりに表示したい場合は、各行を4つのスペース文字で始めることができます。

<p>A paragraph in <b>HTML</b> displayed as code</p>

これはコンピュータコードを表示するためにも機能します。

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

このフォーマットは、コンピュータプログラムのリストや、Markdownがさまざまなタイプのフォーマットを示すために使用する文字を含む可能性が高いその他のテキストによく使用されるので、Markdownのフォーマットは次の行に対してオフになります。

Normally this word would be **bold**.

そのような文字を通常のテキストに含めるには、以下のセクションを参照してください。

特殊文字を使う

処理されずにMarkdownフォーマットをトリガする特殊文字を使用する場合は、単にその前に円記号（\）を付けてください。これは文字の「エスケープ」として知られています。円記号は表示されませんが、入力されたとおりにその直後の文字が表示されます。

\*asterisks, not emphasis\*

になる

*アスタリスク、強調ではない*

のではなく

*emphasis, not asterisks*

これは

アスタリスクではなく強調

関連情報

• マークダウン

MarkdownシステムはMoodleに固有のものではなく、ますます多くのウェブパブリッシングツールで使用されています。あなたはそれについての詳細を見つけることができますhttps://daringfireball.net/projects/markdown/

Moodleは "Markdown Extra"として知られている追加機能を備えたMarkdownのバージョンを使用します。詳細については、 http：//www.michelf.com/projects/php-markdown/extra/を参照してください 。