マークダウンとは
マークダウンは、Web ページ上のテキストをフォーマットするための構文またはルールのセットです。マークダウンは「できるだけ読み書きしやすい」という意味で、マークアップが HTML よりも単純で、自動的に HTML に変換されるため、Web テキストの書式設定が容易になります。これは、Markdown がマークアップを HTML に変換するため、Web ページのコンテンツを作成するために HTML の知識が必要ないことを意味します。
Markdown は、HTML よりも単純なマークアップ言語で、主に日常の文書作成に使用されます。最後に、対応するエディターまたはスクリプトがページ レンダリング用の HTML に変換されます。あなたがライターまたはプログラマーである場合、Markdown は必須のスキルです。
基本的な文法
タイトル
Markdown は HTML タグ h1 ~ h6 に対応する 6 レベルの見出しをサポートします。
# h1
## h2
### h3
#### h4
##### h5
###### h6
上記のマークアップの効果は次のとおりです。
h1
h2
h3
h4
h5
h6
さらに、Markdown は、テキスト サイズを制御するためにアンダースコアを使用する、Setext マークアップ言語の表現に似た別の形式のタイトル表示もサポートしています。
这是一级标题
===
这是二级标题
---
タイトルを扱うこの方法での表示形式は 2 つだけです。つまり、第 1 レベルのタイトルと第 2 レベルのタイトルです。上記のマークアップの効果は次のとおりです。
これは第 1 レベルの見出しです
これは第 2 レベルの見出しです
段落とブロック引用符
覚えておく必要があるのは、Markdown は実際には簡単に記述できる一種の通常のテキストですが、テキストをレンダリングするためにいくつかのタグを追加するだけであるということです。最終的には HTML タグに変換されるため、Markdown を使用してセグメント化するのは非常に簡単です。前後に少なくとも 1 行の空白行を残すだけです。
もう 1 つの一般的な要件は、特定のテキストを強調したい場合があるということです。Markdown では、段落の先頭に強調用の特別な記号 > が用意されており、強調されたテキストが強調表示されます。
> 这段文字将被高亮显示...
リンクまたは画像を挿入する
Markdown によるリンクと画像の処理は、次の構文を使用してマークできます。
[点击跳转至百度](http://www.baidu.com)
![图片](https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.jj20.com%2Fup%2Fallimg%2F1113%2F052420110515%2F200524110515-2-1200.jpg&refer=http%3A%2F%2Fimg.jj20.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1662099296&t=c60a1e6afb602ca136298cea3cc772d4)
注: 参照画像とリンクの唯一の違いは、その前にある感嘆符です。
リスト
Markdown は、順序付きリストと順序なしリストの両方をサポートします。
- 順序なしリストには * または + または - のマークが付けられます
- 順序付きリストは、数字と . で識別されます。例: 1
* 黄瓜
* 玉米
* 茄子
+ 黄瓜
+ 玉米
+ 茄子
- 黄瓜
- 玉米
- 茄子
1. 黄瓜
2. 玉米
3. 茄子
上記のマークアップは次のように表示されます。
- キュウリ
- トウモロコシ
- ナス
- キュウリ
- トウモロコシ
- ナス
- キュウリ
- トウモロコシ
- ナス
- キュウリ
- トウモロコシ
- ナス
順序付きリストの場合、Markdown は最初の項目の数値のみを考慮します。例: 最初の項目番号が 3 などの場合、2 番目の項目は 4 である必要があり、最終的には 3、4、5 と表示されます。最初の番号を指定した場合、後で間違った番号を指定しても問題ありません。Markdown は最初の項目番号のみを考慮します。
複数の段落が 1 つのリスト項目に含まれている場合、正常に表示されるようにするには、* と段落の最初の文字の間に 4 つのスペースが必要です。
* 段落一
小段一
* 段落二
小段二
上記のマークアップは次のように表示されます。
-
段落1
段落1
-
段落2
第2節
さらに、ブロック引用符をリストに追加する場合は、ブロック引用符マーカーもスペース 4 つインデントする必要があります。
* 段落一
> 区块标记一
* 段落二
> 区块标记二
- 段落1
ブロックマーカー1
- 段落2
ブロックマーク2
注: 原則を覚えておいてください。リストで使用するときに問題がある場合は、1 回インデントし、4 つのスペースまたはタブでインデントを表します。1 回インデントしてもうまくいかない場合は、2 回インデントします。
分割線
組版を美しくするために区切り線を追加する場合があります。Markdown で区切り線を追加するのは非常に簡単で、次のいずれかの形式を使用できます。
***
---
強調
場合によっては、テキストの特定の部分を強調したい場合があります。* または _ パッケージを使用するだけです。1 つのシンボルでマークした場合の効果は斜体で、2 つのシンボルでマークした場合の効果は太字で表示されます。
*这里是斜体*
_这里是斜体_
**这里是加粗**
__这里是加粗__
ここに斜体
ここに斜体
ここは太字、
ここは太字
高度な使用法
コードブロックを挿入
IT 界隈で Markdown の人気が高まっている重要な理由は、コードを簡単かつ美しく挿入できることです。
バッククォート ` を使用してラップする方法です。インラインコード参照の場合は、単一のバックティックで囲みます。
var x = 3
これはインラインコード です
コード全体を挿入する場合、効果を確認するには、少なくとも 2 つ以上のバッククォートでコードを囲む必要があります。
```kotlin
fun (x: Int, y: Int): Int {
return x + y
}
```
注: 多くの人はバッククォートの入力方法を知りません。英語モードでは、キーボードの左端にある ESC キーの下にある最初のキーを見つけてクリックします。
テーブルを挿入
Table は Markdown 構文のより複雑なもので、その構文は次のとおりです。
表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二
上記マークアップ表示効果は以下の通りです。
ヘッダ | エントリー 1 | エントリ 2 |
---|---|---|
計画 | プロジェクト 1 | プロジェクト2 |
注: 3 つの短いスラッシュの周囲のコロンは、配置を制御するために使用されます。コロンを左側に配置するだけでテキストが左側に配置され、コロンを右側に配置するだけでテキストが右側に配置されます。両側のコロンは、テキストが中央に配置されることを意味します。
他の
特殊なシンボルの処理
Markdown では、バックスラッシュ \ を使用して、構文で使用される特殊記号を挿入します。Markdown では、主に次のような処理が必要な特殊シンボルがあります。
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
たとえば、バックスラッシュを挿入する必要がある場合は、\\ => \ のように 2 つの連続したバックスラッシュを入力するだけです。
注: 上記の特殊記号をコンテンツに入力する場合は、エスケープに注意する必要があります。エスケープしないと、コンテンツが不完全に表示されたり、レイアウトが混乱したりする可能性があります。
テキストの色付け
Markdown を使用してテキストに色を追加するには、次のようにします。
- 最初にMarkdownで編集する
- HTML としてエクスポートし、色を付ける必要がある部分に手動でタグ <font color='#ff0000'></font> を追加して保存します。
<font color=red>__文字__</font>
上記の表示効果は以下の通りである。
文字