マークダウン

マークダウンについて

マークダウンは、あなたが簡単に強調(太字、斜体)、構造(箇条書きや見出し)そしてリンク(画像や他のウェブリソースへ)を追加することを可能にすることによってMoodleで利用可能な単純なテキスト入力フォーマットを拡張します。

テキストを入力するには、単にテキスト入力領域またはテキストボックスに入力し、段落の終わりでリターンキーを2回押すと、ある段落の終わりと次の段落の始まりの間に空白行が残ります。

マークダウンを使用する

マークダウンを使用するには:

  1. (ユーザーメニューから)エディタの設定を開き、[テキスト領域]を選択します。
  2. [変更を保存]ボタンをクリックします
  3. テキスト入力領域の下にあるプルダウンメニューから[マークダウン形式]を選択します。

テキストを強調する

マークダウン、斜体テキスト、太字テキスト、または太字斜体テキストの3段階の強調を追加できます。これは、強調したいテキストをアスタリスクで囲むことによって達成されます。

 *イタリック*
**大胆な**
***ボールドイタリック***

強調は、単一の単語、一連の単語、または単語の一部にも追加できます。

一言
***一連の単語***
**区別**可能で

この目的のために、アンダースコア(_)をアスタリスクと互換的に使用できます。

見出し

マークダウンを使用すると、テキストを見出しで細分化できます。通常のテキストで3つ以上を使用することは珍しいですが、6つの異なるレベルが使用可能です。たとえば、現在読んでいるテキストには3つのレベルの見出しがあります。

行を1つ以上のハッシュ文字(#)で始めることで見出しを作成できます。 1つのハッシュが最大で最も重要な見出しであり、6つのハッシュがあなたに最も重要でないか最小の見出しを与えます。

 #セクションの見出し
##サブセクションの見出し
###サブサブセクションの見出し

見出しの最初の2つのレベルは最も一般的で、テキストバージョンでより目立つようにするための代替方法で作成できます(出力は前の方法と同じです)。この方法では、タイトルの下に等号(=)またはハイフン( - )を次のように使用します。

セクション見出し
================
小区分の見出し
------------------

リスト

箇条書きリスト

箇条書きのリストは、各行をアスタリスクで始め、その後に箇条書きの内容の前にスペースを入れることで作成できます。スペースは重要であり、忘れないでください。

 *最初のポイント
第二点
* 3点目

番号付きリスト

同様に、番号付きリストは、各行の先頭に数字、スペース、そして関連するテキストを追加することで作成できます。

 1.最初のポイント
第二点
第三点

インデントリスト

箇条書きと番号付きリストを1つの構造に混在させることもできます。

 *トップレベルの弾丸1
  *小弾  
  *小弾2 
*トップレベルの弾丸2  
1.ナンバーワン
   1.ネスト番号付きポイント  
ポイント2

引用段落

各行を山かっこ(>)で始めることで、引用符で囲まれた部分を示すことができます。この文字は、多くの電子メールプログラムで引用符付きのセクションを示すために使用されているために選択されました。出力は通常、両方の余白から引用されたセクションをインデントします。

>これは引用された段落です> 2行にまたがる

段落の最初の行の先頭に単一の山かっこを使用するだけで、入力の手間を省くことができます。

 >これは一重引用符です。
広がっても段落
何行にもわたる。

Webリンク

Webリソースへのリンクを作成するには、2つの方法があります。1つ目は、リンクをインラインで含めること、読者にクリックしてほしいテキストを角括弧で囲むこと、そしてすぐに表示されるページのURL 2組のブラケット間のスペースまたはギャップ。 URLの後に引用符で囲んでリンクのオプションのタイトルを追加することもできます。

文中の[リンク例](https://example.com/ "任意のタイトル")。

タイトルが指定されている場合は、ユーザーがリンクテキストの上にマウスを移動したときに表示される「ツールチップ」に表示されます。上記のリンクで試してください。

リンクが長い場合は、脚注スタイルを使用し、2番目の角かっこで短い識別名をリンクに付けることで(テキストの簡単な説明、フレーズ、または単に数字を使用して)、テキストの流れを妨げないようにできます。

文中の[example link] [ex]

それから、文書内のどこにでも、できればリンク付きの段落の直後、または文書の下部にある他のリンクのURLと共に収集した、のいずれかにIDに関連するURLを定義できます。

 [例]:https://example.com/ "任意のタイトル"

この2番目の例の出力は、最初の例と区別がつかないでしょう。 (特に他の人と一緒に作業している場合は)作業文書を編集しやすくするために整然とした編成にしておくということです。

リンクされたテキストをURLと同じにしたい場合は、最後のショートカットとして、URLを山かっこで囲みます。

 <https://moodle.org/>

画像

画像はWebリンクと非常によく似た方法で含まれていますが、その前に感嘆符が付きます。 '代替テキスト'(代替を意味する代替)は、さまざまな理由で画像を見ることができないユーザーに提供されるため、テキストは視覚的な手がかりがなくても意味があります。これを実行すると、Markdownでテキストを編集している人に、画像の目的に関する注意やヒントも提供されます。

ユーザーが画像の上にマウスを移動すると、「タイトル」が小さなポップアップで表示され、追加情報を提供できます。

 ![代替テキスト](/ path / img.jpg "任意のタイトル")

また、Webリンクと同様に、すべてのURLを「脚注」スタイルの参照とともにまとめて文書を整理できます。画像に短く、一意の名前を付けるだけです。

 ![代替テキスト] [写真]

ドキュメント内の他の場所では、その名前を画像ファイルに関連付けます。

 [写真]:/url/to/img.jpg「任意タイトル」

これが一例です。

 ![Googleロゴ](https://www.google.com/images/logo.gif "Googleのロゴ")

アクセシビリティ上の理由からも重要な「代替テキスト」は、画像へのリンクが壊れているか一時的に利用できない場合にブラウザによって使用されることがよくあります。

 ![壊れた画像の代替テキスト](https://example.com/intentionally.broken.link "この画像は表示されません")

関連情報