{"meta":{"title":"基本的な書き込みと書式設定の構文","intro":"単純な構文を使用して、GitHubで散文とコードの高度な書式設定を作成します。","product":"概要","breadcrumbs":[{"href":"/ja/get-started","title":"概要"},{"href":"/ja/get-started/writing-on-github","title":"GitHub での執筆"},{"href":"/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github","title":"GitHub で書き込みを開始する"},{"href":"/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax","title":"基本的な書式設定の構文"}],"documentType":"article"},"body":"# 基本的な書き込みと書式設定の構文\n\n単純な構文を使用して、GitHubで散文とコードの高度な書式設定を作成します。\n\n## 見出し\n\n見出しを作成するには、見出しテキストの前に 1 \\~ 6 個の # 記号を追加します。 使用する # の数によって、見出しの階層レベルと書体のサイズが決まります。\n\n```markdown\n# A first-level heading\n## A second-level heading\n### A third-level heading\n```\n\n\n\n2 つ以上の見出しを使用すると、GitHubファイル ヘッダー内の \\[アウトライン] メニュー アイコン をクリックしてアクセスできる目次が自動的に生成されます。 各見出しのタイトルは目次に表示され、タイトルをクリックして選択したセクションに移動できます。\n\n\n\n## テキストのスタイル設定\n\nコメント フィールドや `.md` ファイルでは、太字、斜体、取り消し線、下付き文字、または上付き文字のテキストで強調を示すことができます。\n\n| Style | 構文 | キーボード ショートカット | Example | アウトプット |\n| ----- | -- | ------------- | ------- | ------ |\n| 太字 | | | | |\n\n```\n `** **` または `__ __`| \n Command+B (Mac) または Ctrl+B (Windows/Linux) | `**This is bold text**` | \n **これは太字のテキストです** |\n```\n\n\\| 斜体 |\n`* *` または `_ _` | Command+I (Mac) または Ctrl+I (Windows/Linux) | `_This text is italicized_` |\n*このテキストは斜体* |\n\\| 取り消し線 |\n`~~ ~~` または `~ ~` | None | `~~This was mistaken text~~` |\n~~これは間違ったテキストでした~~ |\n\\| 太字とネストされた斜体 |\n`** **` および `_ _` | None | `**This text is _extremely_ important**` |\n**このテキストは *非常に* 重要です** |\n\\| すべて太字と斜体 | `*** ***` | None | `***All this text is important***` |\n***このテキストはすべて重要です*** | \n\\| 下付き | `` | None | `This is a subscript text` | これは 下付きテキスト です |\n\\| 上付き | `` | None | `This is a superscript text` | これは 上付き文字 のテキストです |\n\\| 下線 | ` ` | None | `This is an underlined text` | これは 下線付き テキストです |\n\n## テキストの引用\n\n```\n \n >\n を使用してテキストを引用符で囲むことができます。\n```\n\n```markdown\nText that is not a quote\n\n> Text that is a quote\n```\n\n引用されたテキストは、左に縦線を用いてインデントされ、灰色のフォントで表示されます。\n\n\n\n> \\[!NOTE]\n> 会話を表示するときに、テキストを強調表示してから 「R」と入力することで、コメント内のテキストを自動的に引用符で囲むことができます。, then **Quote reply** をクリックすると、コメント全体を引用できます。 キーボード ショートカットの詳細については、「 [キーボード ショートカット](/ja/get-started/accessibility/keyboard-shortcuts)」を参照してください。\n\n## コードの引用方法\n\n1 つのバックティックを使用して、文内でコードまたはコマンドを呼び出すことができます。 バックティック内のテキストは書式設定されません。 Command+E (Mac) または Ctrl を押すこともできます。 +E (Windows/Linux) キーボード ショートカットを使用して、コード ブロックのバックティックを Markdown 行内に挿入します。\n\n```markdown\nUse `git status` to list all new or modified files that haven't yet been committed.\n```\n\n\n\nコードやテキストを独自で際立ったブロックにフォーマットするには、トリプルバックティックを使用します。\n\n````markdown\nSome basic Git commands are:\n```\ngit status\ngit add\ngit commit\n```\n````\n\n\n\n詳しくは、「[コードブロックの作成と強調表示](/ja/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks)」をご覧ください。\n\nコード スニペットとテーブルを頻繁に編集する場合は、GitHub のすべてのコメント フィールドで固定幅フォントを有効にするとメリットが得られる場合があります。 詳しくは、「[GitHubでの書き込みと書式設定について](/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor)」をご覧ください。\n\n## サポートされているカラー モデル\n\n問題、プルリクエスト、ディスカッションでは、バックティックを使用して文章内の色を強調することができます。 バックティックス内でサポートされているカラー モデルでは、色の視覚化が表示されます。\n\n```markdown\nThe background color is `#ffffff` for light mode and `#000000` for dark mode.\n```\n\n\n\n現在サポートされているカラー モデルを次に示します。\n\n| 色 | 構文 | Example | アウトプット |\n| ---- | --------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |\n| 16進数 | \\`#RRGGBB\\` | \\`#0969DA\\` |  |\n| RGB | \\`rgb(R,G,B)\\` | \\`rgb(9, 105, 218)\\` |  |\n| HSL | \\`hsl(H,S,L)\\` | \\`hsl(212, 92%, 45%)\\` |  |\n\n> \\[!NOTE]\n>\n> * サポートされているカラー モデルでは、バックティック内に先頭または末尾のスペースを含めることはできません。\n> * 色の視覚化は、問題、プル要求、およびディスカッションでのみサポートされます。\n\n## Links\n\nインライン リンクを作成するには、リンク テキストを角かっこ `[ ]`で折り返し、url をかっこで囲んで `( )`。 キーボード ショートカット の Command+K を使用してリンクを作成することもできます。 テキストを選択したら、クリップボードから URL を貼り付けて、選択範囲からリンクを自動的に作成できます。\n\nテキストを強調表示し、キーボード ショートカット Command+V を使用して Markdown ハイパーリンクを作成することもできます。 テキストをリンクに置き換える場合は、キーボード ショートカット の Command+Shift+V を使用します。\n\n`This site was built using [GitHub Pages](https://pages.github.com/).`\n\n\n\n> \\[!NOTE]\n> GitHub は、有効な URL がコメントに書き込まれると、リンクを自動的に作成します。 詳しくは、「[自動リンクされた参照と URL](/ja/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls)」をご覧ください。\n\n## セクションのリンク\n\n見出しがある任意のセクションに直接リンクできます。 レンダリングされたファイルで自動的に生成されたアンカーを表示するには、セクション見出しにカーソルを合わせて アイコンを表示し、アイコンをクリックしてブラウザーにアンカーを表示します。\n\n\n\n編集中のファイル内の見出しのアンカーを決定する必要がある場合は、次の基本ルールを使用できます。\n\n* 文字は小文字に変換されます。\n* スペースはハイフン (`-`) に置き換えられます。 その他の空白文字または句読点文字は削除されます。\n* 先頭と末尾の空白が削除されます。\n* マークアップの書式設定は削除され、内容のみが残ります (たとえば、 `_italics_` は `italics`になります)。\n* 見出しに対して自動的に生成されるアンカーが同じドキュメント内の以前のアンカーと同じ場合は、ハイフンと自動インクリメント整数を追加することで一意の識別子が生成されます。\n\nURI フラグメントの要件の詳細については、「 [RFC 3986: Uniform Resource Identifier (URI): Generic Syntax, Section 3.5](https://www.rfc-editor.org/rfc/rfc3986#section-3.5)」を参照してください。\n\n次のコード ブロックは、レンダリングされたコンテンツの見出しからアンカーを生成するために使用される基本的なルールを示しています。\n\n```markdown\n# Example headings\n\n## Sample Section\n\n## This'll be a _Helpful_ Section About the Greek Letter Θ!\nA heading containing characters not allowed in fragments, UTF-8 characters, two consecutive spaces between the first and second words, and formatting.\n\n## This heading is not unique in the file\n\nTEXT 1\n\n## This heading is not unique in the file\n\nTEXT 2\n\n# Links to the example headings above\n\nLink to the sample section: [Link Text](#sample-section).\n\nLink to the helpful section: [Link Text](#thisll-be-a-helpful-section-about-the-greek-letter-Θ).\n\nLink to the first non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file).\n\nLink to the second non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file-1).\n```\n\n> \\[!NOTE]\n> 見出しを編集する場合、または \"同じ\" アンカーで見出しの順序を変更する場合は、アンカーが変更されるため、それらの見出しへのリンクも更新する必要があります。\n\n## 相対リンク\n\n表示されたファイル中で相対リンクと画像パスを定義して、読者がリポジトリ中の他のファイルにアクセスしやすくできます。\n\n相対リンクは、現在のファイルに対する相対的なリンクです。 たとえば、リポジトリのルートに README ファイルがあり、*docs/CONTRIBUTING.md* に別のファイルがある場合、README の *CONTRIBUTING.md* への相対リンクは次のようになります。\n\n```text\n[Contribution guidelines for this project](docs/CONTRIBUTING.md)\n```\n\nGitHub は相対リンクまたは画像パスを、現在のブランチに基づいて変換するので、リンクやパスは常にうまく働きます。 リンクのパスは、現在のファイルに対する相対パスになります。 `/` で始まるリンクは、リポジトリ ルートに対する相対パスです。 `./` や `../` のような相対リンクのオペランドをすべて使用できます。\n\nリンク テキストは 1 行に記述する必要があります。 次の例は機能しません。\n\n```markdown\n[Contribution\nguidelines for this project](docs/CONTRIBUTING.md)\n```\n\n相対リンクは、リポジトリをクローンするユーザにも扱いやすいです。 絶対リンクはリポジトリのクローンではうまく働かないかもしれません。リポジトリ内の他のファイルを参照するには、相対リンクを使うことをおすすめします。\n\n## カスタム アンカー\n\n標準の HTML アンカー タグ (``) を使用して、ドキュメント内の任意の場所のナビゲーション アンカー ポイントを作成できます。 あいまいな参照を回避するには、 `name` 属性値にプレフィックスを追加するなど、アンカー タグに一意の名前付けスキームを使用します。\n\n> \\[!NOTE]\n> カスタム アンカーは、ドキュメントアウトライン/目次には含まれません。\n\nアンカーに指定した `name` 属性の値を使用して、カスタム アンカーにリンクできます。 構文は、見出しに対して自動的に生成されるアンカーにリンクする場合とまったく同じです。\n\n例えば次が挙げられます。\n\n```markdown\n# Section Heading\n\nSome body text of this section.\n\n\nSome text I want to provide a direct link to, but which doesn't have its own heading.\n\n(… more content…)\n\n[A link to that custom anchor](#my-custom-anchor-point)\n```\n\n> \\[!TIP]\n> カスタム アンカーは、自動見出しリンクの自動名前付けおよび番号付け動作では考慮されません。\n\n## 改行コード\n\nリポジトリで問題、pull request、またはディスカッションを記述している場合、GitHub は改行を自動的にレンダリングします。\n\n```markdown\nThis example\nWill span two lines\n```\n\nただし、.md ファイルで記述している場合、上記の例は改行なしで 1 行にレンダリングされます。 .md ファイルに改行を作成するには、次のいずれかを含める必要があります。\n\n* 最初の行の末尾に 2 つのスペースを含めます。\n
\n This example \n Will span two lines\n
\n\n* 最初の行の末尾にバックスラッシュを含めます。\n\n ```markdown\n This example\\\n Will span two lines\n ```\n\n* 最初の行の末尾に HTML 単一改行タグを含めます。\n\n ```markdown\n This example \n Will span two lines\n ```\n\n2 行の間に空白行を残した場合、.md ファイルと Markdown の両方が問題、pull request、ディスカッションで空白行で区切られた 2 行をレンダリングします。\n\n```markdown\nThis example\n\nWill have a blank line separating both lines\n```\n\n## 画像\n\nを追加することで画像を表示できます 。 代替テキストを `[ ]`で折り返します。 代替テキストは、画像内の情報に相当する短いテキストです。 次に、イメージのリンクをかっこ `()`で囲みます。\n\n``\n\n\n\nGitHub では、問題への画像の埋め込みをサポートしています。pull requests、ディスカッション、コメント、および `.md` ファイル。 リポジトリからイメージを表示したり、オンライン イメージへのリンクを追加したり、イメージをアップロードしたりできます。 詳細については、「 [アセットのアップロード」を](#uploading-assets)参照してください。\n\n> \\[!NOTE]\n> リポジトリ内のイメージを表示する場合は、絶対リンクではなく相対リンクを使用します。\n\n相対リンクを使用して画像を表示する例を次に示します。\n\n| Context | 相対リンク |\n| ---------------------------------- | ---------------------------------------------------------------------- |\n| 同じブランチ上の `.md` ファイル内 | `/assets/images/electrocat.png` |\n| 別のブランチの `.md` ファイル内 | `/../main/assets/images/electrocat.png` |\n| リポジトリの課題、プルリクエスト、コメントにおいて | `../blob/main/assets/images/electrocat.png?raw=true` |\n| 別のリポジトリの `.md` ファイル内 | `/../../../../github/docs/blob/main/assets/images/electrocat.png` |\n| 問題の場合は、別のリポジトリの pull request とコメント | `../../../github/docs/blob/main/assets/images/electrocat.png?raw=true` |\n\n> \\[!NOTE]\n> 上記の表の最後の 2 つの相対リンクは、ビューアーが少なくともこれらのイメージを含むプライベート リポジトリへの読み取りアクセス権を持っている場合にのみ、プライベート リポジトリ内のイメージに対して機能します。\n\n詳細については、「 [相対リンク](#relative-links)」を参照してください。\n\n### Picture 要素\n\n```\n `` HTML 要素がサポートされています。\n```\n\n## Lists\n\n1 行以上のテキストの前に -、 \\*、または +を付けることで、順序付けされていないリストを作成できます。\n\n```markdown\n- George Washington\n* John Adams\n+ Thomas Jefferson\n```\n\n\n\nリストを並べ替える場合は、各行の前に数字を付けておきます。\n\n```markdown\n1. James Madison\n2. James Monroe\n3. John Quincy Adams\n```\n\n\n\n### 入れ子になったリスト\n\n1 つ以上のリスト 項目を別の項目の下にインデントすることで、入れ子になったリストを作成できます。\n\nGitHub の Web エディターまたは [データ](https://code.visualstudio.com/) variables.product.prodname\\_vscode %} などのモノスペース フォントを使用するテキスト エディターを使用して入れ子になったリストを作成するには、リストを視覚的に配置できます。 リスト マーカー文字 (- または \\*) が、その上の項目のテキストの最初の文字のすぐ下に配置されるまで、入れ子になったリスト アイテムの前にスペース文字を入力します。\n\n```markdown\n1. First list item\n - First nested list item\n - Second nested list item\n```\n\n> \\[!NOTE]\n> Web ベースのエディターでは、最初に目的の行を強調表示してから Tab または Shift+Tab を使用して、1 行以上のテキストをインデントまたはデデントできます。\n\n\n\n\n\nモノスペース フォントを使用しない GitHub のコメント エディターで入れ子になったリストを作成するには、入れ子になったリストのすぐ上にあるリスト アイテムを確認し、アイテムのコンテンツの前に表示される文字数をカウントします。 次に、入れ子になったリスト項目の前にその数の空白文字を入力します。\n\nこの例では、入れ子になったリスト アイテムを 5 文字以上インデントすることで、リストアイテム`100. First list item`の下に入れ子になったリストアイテムを追加できます。これは、`100. `前に 5 文字 (`First list item`) があるためです。\n\n```markdown\n100. First list item\n - First nested list item\n```\n\n\n\n同じメソッドを使用して、入れ子になったリストの複数のレベルを作成できます。 たとえば、入れ子になったリスト アイテムの先頭には、入れ子になったリスト コンテンツ`␣␣␣␣␣-␣`の前に 7 文字 (`First nested list item`) があるため、2 番目の入れ子になったリストアイテムを少なくとも 2 文字インデントする必要があります (最小 9 文字)。\n\n```markdown\n100. First list item\n - First nested list item\n - Second nested list item\n```\n\n\n\nその他の例については、[GitHub Flavored Markdown Spec](https://github.github.com/gfm/#example-265) を参照してください。\n\n## タスク リスト\n\nタスク リストを作成するには、リスト アイテムの前に空白、ハイフン、`[ ]` を付けます。 完了したタスクをマークするには、`[x]` を使います。\n\n```markdown\n- [x] #739\n- [ ] https://github.com/octo-org/octo-repo/issues/740\n- [ ] Add delight to the experience when all tasks are complete :tada:\n```\n\n\n\nタスク リスト アイテムの説明がかっこで始まる場合は、 \\\\でエスケープする必要があります。\n\n`- [ ] \\(Optional) Open a followup issue`\n\n詳しくは、「[タスクリストについて](/ja/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists)」をご覧ください。\n\n## 人々やチームのメンション\n\nGitHub で、ユーザー名またはチーム名[](/ja/organizations/organizing-members-into-teams)入力することで、ユーザーまたは@にメンションできます。 これにより通知がトリガーされ、会話に注意が向けられます。 ユーザー名またはチーム名をメンションするようにコメントを編集すると、ユーザーにも通知が届きます。 通知の詳細については、「[通知について](/ja/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications)」を参照してください。\n\n> \\[!NOTE]\n> ユーザーには、そのユーザーがリポジトリへの読み取りアクセス権を持ち、リポジトリが組織によって所有されている場合は、そのユーザーが組織のメンバーである場合にのみ、メンションに関する通知が送信されます。\n\n`@github/support What do you think about these updates?`\n\n\n\n親チームに言及すると、その子チームのメンバーも通知を受け取り、複数のユーザー グループとのコミュニケーションが簡素化されます。 詳しくは、「[Organization のチームについて](/ja/organizations/organizing-members-into-teams/about-teams)」をご覧ください。\n\n```\n \n @\n 記号を入力すると、プロジェクトのユーザーまたはチームの一覧が表示されます。 リストは入力時にフィルター処理されるため、探しているユーザーまたはチームの名前を見つけたら、方向キーを使用して選択し、Tab キーまたは Enter キーを押して名前を完成させることができます。 チームの場合は、 @organization/team-name を入力すると、そのチームのすべてのメンバーが会話にサブスクライブされます。\n```\n\nオートコンプリートの結果は、リポジトリコラボレーターとスレッド上の他のすべての参加者に制限されます。\n\n## 問題と pull request の参照\n\n「 #」と入力すると、リポジトリ内で推奨される問題とプル要求の一覧を表示できます。 問題または pull request 番号またはタイトルを入力して一覧をフィルター処理し、Tab キーまたは Enter キーを押して強調表示された結果を完了します。\n\n詳しくは、「[自動リンクされた参照と URL](/ja/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls)」をご覧ください。\n\n## 外部リソースの参照\n\nデータ 再使用可能なリポジトリ.autolink-リファレンス %}\n\n## アセットのアップロード\n\n画像などのアセットは、ドラッグ アンド ドロップ、ファイル ブラウザーからの選択、貼り付けによってアップロードできます。 リポジトリ内の問題、pull request、コメント、 `.md` ファイルにアセットをアップロードできます。\n\n## 絵文字の使用\n\n```\n `:EMOJICODE:`入力し、コロンの後に絵文字の名前を付けることで、絵文字を文書に追加できます。\n```\n\n`@octocat :+1: This PR looks great - it's ready to merge! :shipit:`\n\n\n\n入力 : 提案された絵文字のリストが表示されます。 入力するとリストがフィルター処理されるため、探している絵文字が見つかると、 **Tab** キーまたは **Enter** キーを押して強調表示された結果を完了します。\n\n利用可能な絵文字とコードの完全な一覧については、 [絵文字チートシートを](https://github.com/ikatyang/emoji-cheat-sheet/blob/github-actions-auto-update/README.md)参照してください。\n\n## 段落\n\nテキスト行間に空白行を残すことで、新しい段落を作成できます。\n\n## 脚注\n\n次の角かっこ構文を使用して、コンテンツに脚注を追加できます。\n\n```text\nHere is a simple footnote[^1].\n\nA footnote can also have multiple lines[^2].\n\n[^1]: My reference.\n[^2]: To add line breaks within a footnote, add 2 spaces to the end of a line. \nThis is a second line.\n```\n\n脚注は次のようにレンダリングされます。\n\n\n\n> \\[!NOTE]\n> マークダウン内の脚注の位置は、脚注がレンダリングされる場所には影響しません。 脚注への参照の直後に脚注を書くことができますが、脚注は Markdown の下部に引き続きレンダリングされます。 脚注は Wiki ではサポートされていません。\n\n## Alerts\n\n```\n **アラート** ( **吹き出し** や **警告**とも呼ばれます) は、重要な情報を強調するために使用できるブロッククォート構文に基づく Markdown 拡張機能です。 GitHub には、コンテンツの重要性を示す独特の色とアイコンが表示されます。\n```\n\nアラートは、ユーザーの成功に不可欠な場合にのみ使用し、読者の過負荷を防ぐために記事ごとに 1 つまたは 2 つに制限します。 さらに、アラートを連続して配置しないようにする必要があります。 アラートを他の要素内に入れ子にすることはできません。\n\nアラートを追加するには、アラートの種類を指定する特殊なブロッククォート行を使用し、その後に標準ブロッククォート内のアラート情報を指定します。 次の 5 種類のアラートを使用できます。\n\n```markdown\n> [!NOTE]\n> Useful information that users should know, even when skimming content.\n\n> [!TIP]\n> Helpful advice for doing things better or more easily.\n\n> [!IMPORTANT]\n> Key information users need to know to achieve their goal.\n\n> [!WARNING]\n> Urgent info that needs immediate user attention to avoid problems.\n\n> [!CAUTION]\n> Advises about risks or negative outcomes of certain actions.\n```\n\n表示されるアラートを次に示します。\n\n\n\n## コメントを含むコンテンツを非表示にする\n\nGitHub に、HTML コメントにコンテンツを配置することで、レンダリングされた Markdown からコンテンツを非表示にすることができます。\n\n```text\n\n```\n\n## マークダウンの書式設定を無視する\n\nGitHub に、Markdown 文字の前に \\\\ を使用してマークダウンの書式設定を無視 (またはエスケープ) するように指示できます。\n\n`Let's rename \\*our-new-project\\* to \\*our-old-project\\*.`\n\n\n\n円記号の詳細については、「Daring Fireball の [マークダウン構文](https://daringfireball.net/projects/markdown/syntax#backslash)」を参照してください。\n\n> \\[!NOTE]\n> マークダウンの書式設定は、問題またはプル要求のタイトルでは無視されません。\n\n## Markdown レンダリングの無効化\n\nMarkdown ファイルを表示するときに、ファイルの上部にある **\\[Code]** をクリックすると、Markdown レンダリングが無効になり、代わりにファイルのソースが表示されます。\n\n![ファイルを操作するためのオプションが示されているリポジトリ内のマークダウン ファイルのスクリーンショット。 \\[コード\\] というラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/writing/display-markdown-as-source-global-nav-update.png)\n\nMarkdown レンダリングを無効にすると、ライン リンクなどのソース ビュー機能を使用できます。これは、レンダリングされた Markdown ファイルを表示する場合には使用できません。\n\n## 詳細については、次を参照してください。\n\n* [GitHub Flavored Markdown の仕様](https://github.github.com/gfm/)\n* [GitHubでの書き込みと書式設定について](/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github)\n* [高度なフォーマットを使用して作業する](/ja/get-started/writing-on-github/working-with-advanced-formatting)\n* [GitHubでの記述に関するクイック スタート](/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)"}