テキスト整形のルール(Markdown記法)
目次
メモ
2025年10月23日より、Markdown記法はGitHub Flavored Markdownに準拠した記法に更新しました。
見出し
2種類の見出しの形式をサポートしています。
下行に「=」や「-」を付けた行は見出しとして見なされます。「=」や「-」の数はいくつでも構いません。
「#」から始まる行も見出しとして見なされます。
見出しを作成する場合は、#と見出しの間に必ず半角スペースを入れてください。
| | |
| | |
| 見出し1=============見出し2-------------# 見出し1## 見出し2### 見出し3#### 見出し4##### 見出し5###### 見出し6
| |
注意
見出しを作成する場合は、#と見出しの間に必ず半角スペースを入れてください。
引用
「>」から始まる行は引用文として表示されます。
| | |
| | |
| > 引用した内容です。> 引用した内容です。> 引用した内容です。
| |
リスト
「*」「+」「-」から始まる行は箇条書きとして見なされます。
数字と「ピリオド」から始まる行は番号付きの箇条書きとして見なされます。
記号の後にはスペースが必要です。
また、各々の階層の中に段落を設けたい場合は4文字のスペースを挿入してください。
| | |
| | |
| * 箇条書き1 段落1 * 箇条書き2 段落2 * 箇条書き2-1 * 箇条書き2-2 段落2-21. 箇条書き12. 箇条書き2 1. 箇条書き2-1 2. 箇条書き2-1-2 1. 箇条書き2-2 1. 箇条書き2-2-13. 箇条書き3 1. 箇条書き3-1
| |
注意
リストを作成する場合は、本文とリストの間に必ず1行以上の空白行を入れてください。
チェックリスト
課題詳細の入力画面にて、リスト記法の先頭を「 [ ] 」または「 [x] 」で開始すると、チェックボックス付きのリストに変換されます。
また、変換されたチェックボックスで、チェックを入れたり外したりすると、課題が更新されます。
メモ
チェックリスト記法は課題詳細のみで使用できます。
| | |
| | |
| * [ ] Item-A* [x] Item-B * [ ] Item-B-1 * [ ] Item-B-2-a
| |
注意
チェックリストを作成する場合は、本文とチェックリストの間に必ず1行以上の空白行を入れてください。
コードブロック
コードブロックを使用したい場合、行頭にスペースを4つ挿入することでコードブロックとして見なされます。
また、「```」で該当部分を囲むことでもコードブロックとして見なされます。
文中の該当部分のみにコードブロックのスタイルを使用したい場合、「`」で括ると、インラインコードとして見なされます。
| | |
| | |
| ```package helloworld;public class Hello { public static void main(String[] args) { System.out.println("Hello World"); }}``````package helloworld;public class Hello { public static void main(String[] args) { System.out.println("Hello World"); }}```
`インラインコード`
| |
注意
コードブロックを作成する場合は、本文とコードブロックの間に必ず1行以上の空白行を入れてください。
罫線
3つ以上の「-」や「*」、「_」だけで構成されている行は罫線となります。
| | |
| | |
| * * *********- - ----------------------------------------_ _ _
| |
注意
罫線の「* * *」と「********」を使用する場合は、本文と罫線の間に必ず1行以上の空白行を入れてください。
リンク
リンク文字列を「[]」囲み、その直後に「()」で囲んだURLを記述することでリンクと見なされます。
また、Backlogでは前後をスペースで区切られたURLやメールアドレスは自動的にリンクと見なされます。
| | |
| | |
| このバグについては、このページ [Backlog](https://backlog.com/ja/) が参考になります。 このバグについては、このページ https://backlog.com/ja/ が参考になります。 support-ja@backlog.com までメールを送ってください。 | このバグについては、このページ Backlog が参考になります。 このバグについては、このページ https://backlog.com/ja/ が参考になります。 support-ja@backlog.com までメールを送ってください。 |
斜体文字、太字、打ち消し
「*」や「_」によって囲まれた文字列は斜体になります。
「**」や「__」によって囲まれた文字列は太字になります。
「~~」で囲まれた文字は打ち消し線を入れることができます。
| 入力文字の例 | 結果 |
| これは*斜体文字*です。 | これは斜体文字です。 |
| これは_斜体文字_です。 | これは斜体文字です。 |
| これは**太字**です。 | これは太字です。 |
| これは__太字__です。 | これは太字です。 |
| これは~~打ち消し~~です。 | これは打ち消しです。 |
メモ
URL全体を<>で囲んだ上で上記それぞれの文字列で囲むことで、URLを斜体や太字にしたり、打ち消し線を入れたりすることができます。
画像
「!」に続き Alt 文字列を「[]」囲み、その直後に「()」で囲んだURLを記述することで画像と見なされます。
| | |
| | |
| 
| |
テーブル
Backlog は PHP Markdown Extra ライクなテーブルをサポートしています。
「|」は列の区切りに使われます。
空白を入れずに「|」入れることでその左のセルを結合することができます。
(横にセルを連結することはできますが、縦に連結することはできません。)
複数の「-」はヘッダー部とボディ部の区切りに使われます。また、その両端を「:」で囲むことでその列を中央寄せに、右端に「:」を付けることで右寄せになります。
最後に「[]」で囲んだ文字列はテーブルのタイトルになります。
| | |
| | |
| | | 結合 |||ヘッダー1| ヘッダー2|ヘッダー3|| :------------- | :------------: | -------------: ||セル1 | 長いセル |||セル2 | 中央寄せ | 右寄せ ||セル3 | **太字** | *斜体* ||セル4 | さらに ||[サンプル]
| |
注意
テーブルを作成する場合は、本文とテーブルの間に必ず1行以上の空白行を入れてください。
定義リスト
Backlog は PHP Markdown Extra ライクな定義リストをサポートしています。
用語を表す1行に続き、「:」で始まる用語の定義を付与することができます。
また、用語ごとに複数の定義を持つことができます。
| | |
| | |
| カレー: 複数の香辛料を使って野菜や肉などのさまざまな食材を味付けした料理。 国際的に人気のある料理のひとつ。: フランス北部パ=ド=カレー県の都市。
シチュー: 野菜や肉、魚介類を出汁やソースで煮込んだ煮込み料理
| |
特殊な文字のエスケープ
「(¥)」を特殊な文字の前に書くことで、Markdown記法と認識されることなく、そのまま文字を出力することが可能です。
| | |
| | |
| \*Not Striked\*\\\\Home\hoge\hoge2
|
*Not Striked*\\Home\hoge\hoge2
|
課題リンク、Wikiページリンク
課題キーを直接書くか、あるいは課題キーを2重かっこで囲むことで、他の課題へのリンクを作成できます。
| | |
| | |
| これはどうやら[[BLG-104]]と同じ現象のようです。BLG-87 も合わせて参照してください。まずは [[Home]] をみてください。
|
これはどうやらBLG-104と同じ現象のようです。BLG-87も合わせて参照してください。まずは Home をみてください。
|
Subversionリビジョンへのリンク
「#rev(リビジョン番号)」と記述するとSubversionのリビジョン詳細へのリンクを挿入できます。
Gitリビジョンへのリンク
「#rev(リポジトリ:リビジョン)」と記述するとGitのリビジョン詳細へのリンクを挿入できます。
Wiki添付ファイルへのリンク
Wikiページに添付されたファイルへのリンクを挿入できます。
通常はツールバーを利用して挿入しますので、記法を意識する必要はありません。
Wiki添付ファイル画像の表示
Wikiページに添付された画像ファイルを挿入できます。
通常はツールバーを利用して挿入しますので、記法を意識する必要はありません。
目次
「[toc]」と記述すると見出しに基づいて目次を作成します。
| | |
| | |
| [toc]# ヘッダ1## ヘッダ1-1## ヘッダ1-2# ヘッダ2## ヘッダ2-1### ヘッダ2-1-1
| |
注意
目次を作成する場合は、本文と目次の間に必ず1行以上の空白行を入れてください。
折りたたみ表示
<details>と<summary>タグを使用することで、文章を折りたたんで表示できます。
| | |
| | |
| <details>
<summary>クリックして詳細を表示</summary>
ここに折りたたまれる内容を記述します。
Markdownの記法も使用できます。
- リスト項目1
- リスト項目2
**太字**や*斜体*も使用できます。
</details>
| |
一般的なMarkdown記法との違い
段落と改行
Markdownでは行頭から書き始めればそれが段落となり、空行を挟むことで別の段落になります。一般的なMarkdownでは段落中の改行は削除されますが、Backlogの場合は無視されずに改行されます。
HTMLタグ
一部のHTMLタグが使用できます。
拡張
Backlogは基本的なMarkdownの記法に加えて以下のような記法をサポートしています。