基本的な書き方とフォーマットの構文

見出し

見出しを作成するには、1 つから 6 つの # シンボルを見出しのテキストの前に追� します。 使用する # の個数によって見出しのサイズが決まります。

# The largest heading
## The second largest heading
###### The smallest heading

2 つ以上の見出しを使用すると、GitHub では自動的に目次が生成されます。この目次には、ファイル ヘッダー内の をクリックするとアクセスできます。 各見出しのタイトルが目次に一覧表示され、タイトルをクリックして選択したセクションに移動できます。

テキストのスタイル設定

コメント フィールドと .md ファイルでは、太字、斜体、取り消し線、下付き、上付きのテキストで強調を示すことができます。

スタイル	構文	キーボード ショートカット	例	出力
太字	** ** または __ __	Command+B (Mac) または Ctrl+B (Windows/Linux)	**This is bold text**	これは太字のテキストです
[斜体]	* * または _ _	Command+I (Mac) または Ctrl+I (Windows/Linux)	*This text is italicized*	このテキストは斜体です
取り消し線	~~ ~~		~~This was mistaken text~~	これは間違ったテキストでした
太字および太字中にある斜体	** ** および _ _		**This text is _extremely_ important**	このテキストは きわめて 重要です
全体が太字かつ斜体	*** **_		_*_All this text is important_*_	*すべてのテキストが重要です_**
Subscript	<sub> </sub>		<sub>This is a subscript text</sub>	これは下付きテキストです
Superscript	<sup> </sup>		<sup>This is a superscript text</sup>	これは上付きテキストです

テキストの引用

> を使用してテキストを引用符で囲みます。

Text that is not a quote

> Text that is a quote

コードの引用

単一のバッククォートで文� 内のコードやコマンドを引用できます。 バッククォート内のテキストはフォーマットされません。 また、Command + E キー (Mac) または Ctrl + E キー (Windows/Linux) のキーボード ショートカットを押して、Markdown 行内にコード ブロックのバッククォートを挿入することもできます。

Use `git status` to list all new or modified files that haven't yet been committed.

独立したブロック内にコードあるいはテキストをフォーマットするには、3 重のバッククォートを使用します。

Some basic Git commands are:
```
git status
git add
git commit
```

詳細については、「コード ブロックの作成と強調表示」を参照してく� さい。

サポートされているカラー モデル

issue、pull request、ディスカッションでは、バックティックを使って文内の色を呼び出すことができます。 バックティック内でサポートされているカラー モデルでは、色の視覚化が表示されます。

The background color should be `#ffffff` for light mode and `#0d1117` for dark mode.

現在サポートされているカラー モデルを次に示します。

Color	構文	例	出力
HEX	`#RRGGBB`	`#0969DA`
RGB	`rgb(R,G,B)`	`rgb(9, 105, 218)`
HSL	`hsl(H,S,L)`	`hsl(212, 92%, 45%)`

リンク

インライン リンクを作成するには、リンク テキストを角かっこ [ ] で囲み、URL をかっこ ( ) で囲みます。 また、キーボード ショートカット Command + K を使ってリンクを作成することもできます。

This site was built using [GitHub Pages](https://pages.github.com/).

セクションリンク

セクションのヘッディング上にカーソルを移動させてリンクを表示させることにより、表示されたファイル中のセクションに対して直接リンクできます。

Relative links (相対リンク)

表示されたファイル中で相対リンクと画像パスを定義して、読者がリポジトリ中の他のファイルにアクセスしやすくできます。

相対リンクは、現在のファイルに対する相対的なリンクです。 たとえば、リポジトリのルートに README ファイルがあり、docs/CONTRIBUTING.md に別のファイルがある� �合、README の CONTRIBUTING.md への相対リンクは次のようになります。

[Contribution guidelines for this project](docs/CONTRIBUTING.md)

GitHub Enterprise Serverは相対リンクあるいは画像パスを、現在のブランチに基づいて変換するので、リンクやパスは常にうまく働きます。 リンクのパスは、現在のファイルに対する相対パスになります。 / で始まるリンクは、リポジトリ ルートに対する相対パスです。 ./ や ../ のような相対リンクのオペランドをすべて使用できます。

相対リンクは、リポジトリをクローンするユーザにも扱いやすいです。 絶対リンクはリポジトリのクローンではうまく働かないかもしれません。リポジトリ内の他のファイルを参照するには、相対リンクを使うことをおすすめします。

画像

! を追� して、代替テキストを [ ] 内にラップすると、画像を表示できます。 次に、イメージのリンクをかっこ () で囲みます。

![This is an image](https://myoctocat.com/assets/images/base-octocat.svg)

GitHub Enterprise Server では、問題へのイメージの埋め込み、プル要求、コメントと .md ファイルがサポートされます。 リポジトリからイメージを表示したり、オンライン イメージにリンクを追� したり、イメージをアップロードしたりできます。 詳細については、「アセットをアップロードする」を参照してく� さい。

相対リンクを使用して画像を表示する例を次に示します。

Context	相対リンク
同じブランチ上の .md ファイル内	/assets/images/electrocat.png
別のブランチ上の .md ファイル内	/../main/assets/images/electrocat.png
リポジトリの問題、プル要求、コメント内	../blob/main/assets/images/electrocat.png?raw=true
別のリポジトリ内の .md ファイル内	/../../../../github/docs/blob/main/assets/images/electrocat.png
別のリポジトリの問題、プル要求、コメント内	../../../github/docs/blob/main/assets/images/electrocat.png?raw=true

詳細については、「相対リンク」を参照してく� さい。

リスト

1 つまたは複数の行の前に -、*、または + を置くことで、� �序なしリストを作成できます。

- George Washington
* John Adams
+ Thomas Jefferson

リストを� �序付けするには、各行の前に数字を置きます。

1. James Madison
2. James Monroe
3. John Quincy Adams

入れ子になったリスト

1 つ以上のリストアイテ� を他のアイテ� の下にインデントすることで、入れ子になったリストを作成できます。

GitHub Enterprise Server 上の Web エディター、または Visual Studio Code のようなモノスペース フォントを使用するテキスト エディターを使って、入れ子になったリストを作成するには、リストが揃って見えるように編集できます。 入れ子になったリスト アイテ� の前に空白を、リスト マーカー文字 (- または *) が直接上位のアイテ� 内のテキストの一文字目の下に来るように入力してく� さい。

1. First list item
   - First nested list item
     - Second nested list item

モノスペースフォントを使っていない GitHub Enterprise Serverのコメントエディタで入れ子になったリストを作成するには、入れ子になったリストのすぐ上にあるリストアイテ� を見て、そのアイテ� の内容の前にある文字数を数えます。 そして、その数� け空白を入れ子になったリストアイテ� の前に入力します。

この例では、入れ子になったリスト アイテ� を少なくとも 5 つのスペースでインデントすることで、リスト� �目 100. First list item の下に入れ子になったリスト アイテ� を追� できます。First list item の前に 5 文字 (100. ) があるためです。

100. First list item
     - First nested list item

同じ方法で、複数レベルの入れ子になったリストを作成できます。 たとえば、最初の入れ子になったリスト アイテ� は入れ子になったリストコンテンツ First nested list item の前に 7 文字 (␣␣␣␣␣-␣)があるため、2 番目の入れ子になったリスト アイテ� を 7 つのスペースでインデントする必要があります。

100. First list item
     - First nested list item
       - Second nested list item

その他の例については、「GitHub 用の Markdown 仕様」を参照してく� さい。

タスク リスト

タスク リストを作成するには、リスト アイテ� の前に空白、ハイフン、[ ] を付けます。 完了したタスクをマークするには、[x] を使います。

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

タスク リスト アイテ� の説明がかっこで始まる� �合、そのかっこを \ でエスケープする必要があります。

- [ ] \(Optional) Open a followup issue

詳細については、「タスク リストについて」を参照してく� さい。

人や Team のメンション

@ とユーザー名またはチー� 名を入力することで、人またはチー� を GitHub Enterprise Server でメンションできます。 これにより通知がトリガーされ、会話に注意が向けられます。 コメントを編集してユーザ名や Team 名をメンションすれば、人々に通知を受信してもらえます。 通知の詳細については、「通知について」を参照してく� さい。

@github/support What do you think about these updates?

親チー� にメンションすると、その子チー� のメンバーも通知を受けることになり、複数のグループの人々とのコミュニケーションがシンプルになります。 詳細については、「Team について」を参照してく� さい。

@ シンボルを入力すると、プロジェクト上の人々あるいはチー� のリストが現れます。 このリストは入力していくにつれて絞り込まれていくので、探している人あるいは Team の名前が見つかり次第、矢印キーを使ってその名前を選択し、Tab キーまたは Enter キーを押して名前の入力を完了できます。 チー� については、@organization/team-name と入力すればそのチー� の全メンバーにその会話をサブスクライブしてもらえます。

オートコンプリートの結果は、リポジトリのコラボレータとそのスレッドのその他の参� 者に限定されます。

Issue およびプルリクエストの参照

# と入力して、リポジトリ内のサジェストされた Issue とプル要求のリストを表示させることができます。 Issue あるいはプルリクエストの番号あるいはタイトルを入力してリストをフィルタリングし、Tab キーまたは Enter キーを押して、ハイライトされた結果の入力を完了してく� さい。

詳細については、「自動リンクされた参照と URL」を参照してく� さい。

外部リソースの参照

カスタ� の自動リンク参照がリポジトリに設定されているなら、JIRAのIssueやZendeskのチケットのような外部リソースへの参照は、短縮リンクに変換されます。 リポジトリで利用できる自動リンクを知るには、リポジトリの管理権限を持つ人に連絡してく� さい。 詳細については、「外部リソースを参照する自動リンクの構成」を参照してく� さい。

コンテンツの添付

GitHub Apps には、登録されたドメインにリンクする URL に対する情� �を GitHub Enterprise Server 内で提供するものがあります。 GitHub Enterprise Server は、アプリケーションが提供した情� �を Issue あるいはプルリクエストのボディもしくはコメント中の URL の下に表示します。

コンテンツ添付ファイルを表示するには、リポジトリにインストールされている Content Attachments API を使用する GitHub App が必要です。

コンテンツの添付は、Markdown のリンクの一部になっている URL には表示されません。

コンテンツの添付を利用する GitHub App の構築に関する詳細については、「添付コンテンツを使用する」を参照してく� さい。

アセットをアップロードする

ドラッグアンドドロップ、ファイルブラウザから選択、または貼り付けることにより、画像などのアセットをアップロードできます。 アセットをリポジトリ内の Issue、プル要求、コメント、.md ファイルにアップロードできます。

絵文字の利用

:EMOJICODE: と入力 すると、絵文字を書き込みに追� できます。

@octocat :+1: This PR looks great - it's ready to merge! :shipit:

: と入力すると、絵文字のサジェストリストが表示されます。 このリストは、入力を進めるにつれて絞り込まれていくので、探している絵文字が見つかり次第、Tab または Enter を押して、ハイライトされているものを入力してく� さい。

使用可能な絵文字とコードの完全な一覧については、「絵文字チート シート」を参照してく� さい。

段落

テキスト行の間に空白行を残すことで、新しいパラグラフを作成できます。

脚注

次の角かっこ構文を使用して、コンテンツに脚注を追� できます。

Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].  

You can also use words, to fit your writing style more closely[^note].

[^1]: My reference.
[^2]: Every new line should be prefixed with 2 spaces.  
  This allows you to have a footnote with multiple lines.
[^note]:
    Named footnotes will still render with numbers instead of the text but allow easier identification and linking.  
    This footnote also has been made with a different syntax using 4 spaces for new lines.

脚注は次のようにレンダリングされます。

コメントを使用してコンテンツを非表示にする

GitHub Enterprise Server に対し、コンテンツを HTML コメント内に配置することで、レンダリングされた Markdown からコンテンツを非表示にすることができます。

<!-- This content will not appear in the rendered Markdown -->

Markdown のフォーマットの無視

GitHub Enterprise Server に対し、Markdown のキャラクタの前に \ を使用することで、Markdown のフォーマットを無視 (エスケープ) させることができます。

Let's rename \*our-new-project\* to \*our-old-project\*.

詳細については、Daring Fireball の「Markdown 構文」を参照してく� さい。

Markdown レンダリングの無効化

Markdown ファイルを確認するときは、ファイルの上部にある をクリックすると、Markdown レンダリングを無効にして、代わりにファイルのソースを表示することができます。

Markdown レンダリングを無効にすると、ライン リンクなどのソース ビュー機能を使用できます。これは、レンダリングされた Markdown ファイルを表示する� �合には使用できません。

参考資料

• GitHub Flavored Markdown の仕様
• GitHub 上での執筆とフォーマットについて
• Working with advanced formatting (高度な書式設定を使った作業)
• GitHub での記述に関するクイックスタート