mirror of
https://github.com/reonokiy/blog.nokiy.net.git
synced 2025-06-17 03:56:19 +02:00
chore: update i18n md style guide articles
This commit is contained in:
radishzzz
parent
ece7351668
commit
e3730749de
8 changed files with 424 additions and 300 deletions
|
|
@ -8,95 +8,127 @@ lang: ja
|
|||
abbrlink: markdown-style-guide
|
||||
---
|
||||
|
||||
以下は Retypeset テーマで使用できる基本的な Markdown 構文の例です。
|
||||
以下は Retypeset テーマで使用できる基本的な Markdown 構文の例とそのスタイル効果です。
|
||||
|
||||
## 見出し
|
||||
|
||||
HTML の `<h1>` から `<h6>` タグは6段階の見出しレベルに対応しています。`<h1>` が最高レベルの見出しで、`<h6>` が最低レベルです。
|
||||
テキストの前にシャープ記号 `#` とスペースを追加することで、見出しを作成できます。シャープ記号の数が見出しのレベルに対応します。
|
||||
|
||||
### 構文
|
||||
|
||||
```
|
||||
# 見出し 1
|
||||
## 見出し 2
|
||||
### 見出し 3
|
||||
#### 見出し 4
|
||||
##### 見出し 5
|
||||
###### 見出し 6
|
||||
```
|
||||
|
||||
### 効果
|
||||
|
||||
# 見出し 1
|
||||
|
||||
## 見出し 2
|
||||
|
||||
### 見出し 3
|
||||
|
||||
#### 見出し 4
|
||||
|
||||
##### 見出し 5
|
||||
|
||||
###### 見出し 6
|
||||
|
||||
## 段落
|
||||
|
||||
空行を使用してテキストを区切ることで、段落を作成できます。
|
||||
|
||||
### 構文
|
||||
|
||||
```
|
||||
孔乙己が店に入ると、酒を飲んでいた人々は皆彼を見て笑い、中には「孔乙己、顔にまた新しい傷ができたな！」と声をかける者もいた。彼は答えず、店の主人に「お酒を二杯温めて、茴香豆を一皿」と言い、九文の銭を出した。彼らはまた意図的に大声で「また人の物を盗んだに違いない！」と言った。孔乙己は目を大きく開いて「どうして人の清白を無実に汚すのか…」「何が清白だ？一昨日、何家の本を盗んで、吊るされて叩かれたのを見たぞ」と言われると、孔乙己は顔を赤くし、額の青筋が浮き上がり、「書を盗むのは盗みとは言えない…書を盗む！…読書人の行いが、どうして盗みと言えようか？」と反論し、続いて「君子固窮」や「者乎」などの難解な言葉を並べ立て、人々を大笑いさせた。店内外は陽気な空気に満ちていた。
|
||||
|
||||
人々の裏話によると、孔乙己はもともと勉強していたが、結局科挙に合格せず、生計を立てる方法も知らなかった。そのため、だんだん貧しくなり、ついには物乞いをしなければならなくなった。
|
||||
```
|
||||
|
||||
### 効果
|
||||
|
||||
孔乙己が店に入ると、酒を飲んでいた人々は皆彼を見て笑い、中には「孔乙己、顔にまた新しい傷ができたな！」と声をかける者もいた。彼は答えず、店の主人に「お酒を二杯温めて、茴香豆を一皿」と言い、九文の銭を出した。彼らはまた意図的に大声で「また人の物を盗んだに違いない！」と言った。孔乙己は目を大きく開いて「どうして人の清白を無実に汚すのか…」「何が清白だ？一昨日、何家の本を盗んで、吊るされて叩かれたのを見たぞ」と言われると、孔乙己は顔を赤くし、額の青筋が浮き上がり、「書を盗むのは盗みとは言えない…書を盗む！…読書人の行いが、どうして盗みと言えようか？」と反論し、続いて「君子固窮」や「者乎」などの難解な言葉を並べ立て、人々を大笑いさせた。店内外は陽気な空気に満ちていた。
|
||||
|
||||
人々の裏話によると、孔乙己はもともと勉強していたが、結局科挙に合格せず、生計を立てる方法も知らなかった。そのため、だんだん貧しくなり、ついには物乞いをしなければならなくなった。
|
||||
|
||||
## 画像
|
||||
|
||||
感嘆符 `!`、角括弧 `[]`、丸括弧 `()` を使用して画像を追加できます。これらの記号は全て半角記号を使用し、全角記号は使用しません。
|
||||
|
||||
### 構文
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
### 出力
|
||||
### 効果
|
||||
|
||||
|
||||
|
||||
## 引用ブロック
|
||||
|
||||
引用ブロック要素は他のソースから引用したコンテンツを表し、オプションで `footer` または `cite` 要素内に引用元を含めることができます。また、引用ブロック内で `<mark>`、`<abbr>` などのタグを使用することもできます。
|
||||
段落の前に `>` 記号とスペースを追加することで、引用ブロックを作成できます。段落間の空行に `>` 記号を追加することで、複数の段落を含めることができます。引用元を示す必要がある場合は、`<cite>` または `<footer>` タグを使用して出典を追加し、`[^1]` または `[^note]` 形式で脚注を挿入できます。
|
||||
|
||||
### 出典のない引用ブロック
|
||||
### 複数段落の引用
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
> 天地不仁、以万物為芻狗。<br>
|
||||
> 天地不仁、以万物為芻狗。
|
||||
>
|
||||
> **注意**：引用ブロック内でも _Markdown 構文_ が使えます。
|
||||
```
|
||||
|
||||
#### 出力
|
||||
#### 効果
|
||||
|
||||
> 天地不仁、以万物為芻狗。<br>
|
||||
> 天地不仁、以万物為芻狗。
|
||||
>
|
||||
> **注意**：引用ブロック内でも _Markdown 構文_ が使えます。
|
||||
|
||||
### 出典付きの引用ブロック
|
||||
### 出典付きの引用
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。<br>
|
||||
> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。
|
||||
>
|
||||
> —— <cite>『秋の夜』[^1]</cite>
|
||||
|
||||
[^1]: [『秋の夜』](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85))は魯迅の散文詩集『野草』の最初の散文詩で、1924年に書かれました。
|
||||
```
|
||||
|
||||
#### 出力
|
||||
#### 効果
|
||||
|
||||
> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。<br>
|
||||
> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。
|
||||
>
|
||||
> —— <cite>『秋の夜』[^1]</cite>
|
||||
|
||||
[^1]: [『秋の夜』](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85))は魯迅の散文詩集『野草』の最初の散文詩で、1924年に書かれました。
|
||||
|
||||
## 表
|
||||
|
||||
ハイフン `---` を3つ以上使用してタイトルを区切り、パイプ記号 `|` を使用して列を区切ることで、表を作成できます。
|
||||
|
||||
### 構文
|
||||
|
||||
```markdown
|
||||
| イタリック体 | 太字 | コード |
|
||||
| イタリック体 | 太字 | コード |
|
||||
| ---------- | ------- | ------- |
|
||||
| _イタリック_ | **太字** | `コード` |
|
||||
| _イタリック_ | **太字** | `コード` |
|
||||
```
|
||||
|
||||
### 出力
|
||||
### 効果
|
||||
|
||||
| イタリック体 | 太字 | コード |
|
||||
| イタリック体 | 太字 | コード |
|
||||
| ---------- | ------- | ------- |
|
||||
| _イタリック_ | **太字** | `コード` |
|
||||
| _イタリック_ | **太字** | `コード` |
|
||||
|
||||
## コードブロック
|
||||
|
||||
コードの前後に3つのバッククォート ``` を追加してコードブロックを作成します。最初のバッククォートの後に言語タイプ（html、javascript、css、markdownなど）を指定することで、構文ハイライトを実現できます。
|
||||
コードの上部と下部に3つのバッククォート ```` ``` ```` を追加することで、コードブロックを作成できます。上部のバッククォートの後に言語タイプ（html、javascript、css、markdownなど）を指定することで、シンタックスハイライトを実現できます。
|
||||
|
||||
### 構文
|
||||
|
||||
|
|
@ -115,7 +147,7 @@ HTML の `<h1>` から `<h6>` タグは6段階の見出しレベルに対応し
|
|||
```
|
||||
````
|
||||
|
||||
### 出力
|
||||
### 効果
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
|
|
@ -142,7 +174,7 @@ HTML の `<h1>` から `<h6>` タグは6段階の見出しレベルに対応し
|
|||
3. 3番目の項目
|
||||
```
|
||||
|
||||
#### 出力
|
||||
#### 効果
|
||||
|
||||
1. 最初の項目
|
||||
2. 2番目の項目
|
||||
|
|
@ -154,14 +186,14 @@ HTML の `<h1>` から `<h6>` タグは6段階の見出しレベルに対応し
|
|||
|
||||
```markdown
|
||||
- リスト項目
|
||||
- 別の項目
|
||||
- 図表項目
|
||||
- さらに別の項目
|
||||
```
|
||||
|
||||
#### 出力
|
||||
#### 効果
|
||||
|
||||
- リスト項目
|
||||
- 別の項目
|
||||
- 図表項目
|
||||
- さらに別の項目
|
||||
|
||||
### ネストされたリスト
|
||||
|
|
@ -178,7 +210,7 @@ HTML の `<h1>` から `<h6>` タグは6段階の見出しレベルに対応し
|
|||
- 大根
|
||||
```
|
||||
|
||||
#### 出力
|
||||
#### 効果
|
||||
|
||||
- フルーツ
|
||||
- リンゴ
|
||||
|
|
@ -201,7 +233,7 @@ X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
|||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> はビットマップ画像形式の一種です。
|
||||
|
||||
書物は人類の進歩の<del>階段</del>梯子です。
|
||||
本は人類の進歩の<del>階段</del>梯子である
|
||||
|
||||
優れた作家は常に<u title="スペリング">つづり</u>の間違いをチェックします。
|
||||
|
||||
|
|
@ -210,7 +242,7 @@ X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
|||
ほとんどの<mark>サンショウウオ</mark>は夜行性で、昆虫や虫などの小さな生き物を捕食します。
|
||||
```
|
||||
|
||||
### 出力
|
||||
### 効果
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
|
|
@ -218,7 +250,7 @@ X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
|||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> はビットマップ画像形式の一種です。
|
||||
|
||||
書物は人類の進歩の<del>階段</del>梯子です。
|
||||
本は人類の進歩の<del>階段</del>梯子である
|
||||
|
||||
優れた作家は常に<u title="スペリング">つづり</u>の間違いをチェックします。
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue