マークダウン入門ナビ 
プロジェクト管理やタスク管理、社内Wikiツールとして多くのチームで導入されている「Backlog（バックログ）」。日々の課題起票やコメントのやり取り、仕様書・議事録のWiki作成において、「テキストを見やすく装飾したい」「チェックボックスで見積もりやタスクを管理したい」「表やソースコードを綺麗にレイアウトしたい」と感じる場面は多いのではないでしょうか。
Backlogは、世界標準の軽量マークアップ言語である「Markdown（マークダウン）記法」に完全対応しています。キーボード入力だけで素早く見出しや箇条書き、表組みを反映できるため、チームの情報共有スピードとドキュメントの視認性を劇的に向上させることが可能です。
しかし一方で、「BacklogでMarkdown記法を入力しても記号のまま反映されない」「プロジェクト設定でどうやって切り替えるの？」「Backlog記法とMarkdown記法の違いは？」「課題リンクやWikiでの目次の出し方は？」といった疑問やトラブルを抱えるユーザーも少なくありません。
そこで本記事では、BacklogでMarkdown記法を有効化する設定手順から、課題やWikiで使える全記法チートシート、チェックボックスや表の実例、反映されない時の原因と解決策、Backlog記法との比較までをわかりやすく完全解説します！
📌 目次
- 1. 【早見表】Backlogで使えるMarkdown記法一覧チートシート
- 2. BacklogでMarkdown記法を使うための設定手順＆注意点
- 3. Backlogの課題・Wikiで使える主要Markdown記法の書き方＆実例
- 4. 「Backlogでマークダウンが反映されない・効かない」時の6大原因と対処法
- 5. 「Backlog記法」と「Markdown記法」の比較｜どちらを選ぶべき？
- 6. BacklogのMarkdown利用に関するよくある質問（FAQ）
- 7. まとめ｜BacklogのMarkdownを活用して業務連絡・ドキュメント作成を効率化しよう
- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド
1. 【早見表】Backlogで使えるMarkdown記法一覧チートシート
まずは、Backlogの課題登録・コメント投稿・Wikiページ作成で頻繁に利用する主要なMarkdown記法を一覧表にまとめました。入力に迷った際は、この表を参考にコピー＆ペーストしてご活用ください。
💡 BacklogでのMarkdown入力の基本原則
BacklogのMarkdown記法はCommonMark / GitHub Flavored Markdown（GFM）準拠です。記号（#、*、-、>、` など）はすべて「半角英数字」で入力し、見出しやリストの記号の後には必ず「半角スペース」を空けてください。
| 装飾・機能 | 入力するMarkdown構文 | Backlogでの表示・動作 |
|---|---|---|
| 見出し 1〜3 | # 大見出し## 中見出し### 小見出し |
サイズに応じた見出しスタイル（下線付き区切り） |
| 太字（ボールド） | **太字テキスト** または __太字__ |
太字テキスト（強調表示） |
| 斜体（イタリック） | *斜体テキスト* または _斜体_ |
斜体テキスト（傾いた文字） |
| 取り消し線 | ~~打ち消しテキスト~~ |
|
| 箇条書きリスト | - 項目1- 項目2（* や + も可） |
・項目1 ・項目2（ビュレットリスト） |
| 番号付きリスト | 1. 手順12. 手順2 |
1. 手順1 2. 手順2（自動連番） |
| チェックボックス （タスクリスト） |
- [ ] 未完了タスク- [x] 完了タスク |
チェック可能なボックス（Wiki閲覧画面でON/OFF切替可能） |
| 引用 | > 引用メッセージ |
左枠線付きの引用ブロック |
| インラインコード | `code` |
code（等幅フォント・グレー背景） |
| コードブロック （ハイライト対応） |
```php |
言語指定に応じたシンタックスハイライト付きコード枠 |
| 表（テーブル） | | 列1 | 列2 | |
罫線付きの整列された表テーブル |
| リンク | [表示名](URL) |
リンク付きテキスト |
| 課題キーリンク | PROJ-123（課題キーを記述） |
自動的に該当課題へのクリック可能リンクに変換 |
| ユーザーメンション | @username |
対象ユーザーへの通知付きメンションリンク |
| Wiki目次生成 | [toc] または [[TOC]] |
ページ内の見出しから自動生成されたクリック可能な目次 |
📖 関連ガイド： Markdownの書き方を基礎から網羅したい方は「【コピペで使える】Markdown記法一覧・チートシート」もあわせてご覧ください。
2. BacklogでMarkdown記法を使うための設定手順＆注意点
「Backlogで # や ** を入力したのに、記号がそのまま表示されて装飾されない…」という場合、そのプロジェクトの「テキスト整形のルール」がMarkdown記法に設定されていないことが主な原因です。
Backlogでは、テキスト記法（Backlog記法 または Markdown記法）をプロジェクト単位で設定します。
・プロジェクト設定で「Markdown記法」に切り替える手順
プロジェクトの管理者権限をお持ちの方は、以下の手順で簡単に記法を切り替えることができます。
⚙️ Markdown記法への変更ステップ
- Backlog画面左側のサイドバーメニューから「プロジェクト設定」をクリックします。
- プロジェクト設定画面の「一般」タブを開きます。
- ページ内にある「テキスト整形のルール」の項目を探します。
- ラジオボタンで「Markdown」を選択します。
- ページ下部の「更新」ボタンをクリックして保存します。
※新規プロジェクトを作成する際にも、「テキスト整形のルール」で「Markdown」を選択してプロジェクトを作成することができます。
・記法変更時の注意点（既存課題・Wikiのテキスト崩れ）
⚠️ 運用中のプロジェクトで記法を変更する場合の重要注意点
既に「Backlog記法」で多数の課題やWikiが登録されているプロジェクトで途中から「Markdown記法」へ変更すると、過去にBacklog記法で書かれたテキスト（見出しの * や太字の ''、表など）がMarkdownとして正しく解釈されず、レイアウト崩れを起こす可能性があります。
そのため、運用中のプロジェクトで記法を変更する場合は、チーム内で事前に周知するか、原則として「新規プロジェクトの立ち上げ時」にMarkdown記法を選択することを強く推奨します。
3. Backlogの課題・Wikiで使える主要Markdown記法の書き方＆実例
ここからは、Backlogの課題詳細・コメント入力欄・Wikiページで活用できる具体的なMarkdown記法の書き方を、実例付きで詳しく見ていきましょう。
① 見出し（H1〜H6）
課題の要件定義やWikiの長文ドキュメントを整理する際、見出しを使うことで全体の構造が一目で把握できるようになります。
# 機能要件の概要（H1）
## 1. ユーザー管理機能（H2）
### 1-1. 新規登録フロー（H3）
#### 詳細仕様（H4）- ポイント：
#の個数（1個〜6個）で見出しレベルが変わります。#の後には必ず半角スペースを空けてください。 - Backlogの課題やWikiでは、見出しの下に自動で境界線が入るなど、視認性の高いスタイルが適用されます。
- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド
② 太字・斜体・取り消し線（テキスト装飾）
締め切り日時や重要な注意事項、変更前の古い仕様を表現する際に重宝します。
納期は **9月30日（水）厳守** でお願いします。（太字）
*こちらの参考URL* もあわせてご確認ください。（斜体）
~~旧APIエンドポイント~~ は廃止されました。（取り消し線）💡 日本語文中で太字を使うときのコツ
日本語の文章の中に直接 これは**重要**です と書くと、前後の文字との境界が認識されず太字にならない場合があります。その際は これは **重要** です のように、アスタリスクの外側に半角スペースを1つ挟むと確実に反映されます。
👉 太字・文字装飾の詳しいルールは「Markdownテキスト装飾一覧ガイド」で解説しています。
③ 箇条書きリスト・番号付きリスト
不具合の再現手順や会議のアジェンダ、変更箇所の一覧化に必須の記法です。
- フロントエンド改修
- ログイン画面のバリデーション強化（スペース2〜4個でインデント）
- エラーメッセージの文言統一
- バックエンドAPI改修
1. staging環境へアクセスする
2. テストユーザーでログインする
3. 「購入」ボタンをクリックしてレスポンスを確認する- 階層化（ネスト）： リストの行頭に半角スペース（2〜4個）を入れることで、階層構造（サブリスト）を作成できます。
- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド
👉 リストの書き方・インデント階層化の詳細は「Markdown箇条書き・リストの書き方完全ガイド」をご覧ください。
④ チェックボックス（タスクリスト・ToDo）
BacklogのMarkdown記法において、最も実用的で人気の高い機能の1つが「チェックボックス（タスクリスト）」です。
### 動作確認チェックリスト
- [ ] Chromeでのレイアウト確認
- [ ] Safariでのレイアウト確認
- [x] iOS実機での動作確認（完了）
- [ ] リリース判定会議の実施🌟 Backlog Wikiのチェックボックスは閲覧画面から直接クリック可能！
BacklogのWikiにチェックボックスを配置すると、わざわざ編集画面を開かなくても、通常の閲覧画面上でチェックボックスを直接クリックしてON/OFFを切り替えることができます！リリース手順書やテストチェックリストの運用が圧倒的にスムーズになります。
👉 チェックボックスの記述テクニックや活用法は「Markdownチェックボックスの書き方完全ガイド」で解説しています。
⑤ 引用（引用ブロック）
顧客からの問い合わせメール文面や、過去のコメント・仕様書の一節を引用して議論する際に利用します。
> ユーザーより「パスワードリセットメールが届かない」との問い合わせあり。
上記の件について、メール配信サーバーのログ調査を実施しました。> の後にテキストを入力します。>> と重ねることで2重引用（ネスト引用）も可能です。
⑥ インラインコード＆コードブロック（シンタックスハイライト）
エンジニア間の技術的なやり取りや、SQL・コマンド・JSON・エラーログの共有に不可欠です。
・インラインコード（文中の変数名やパス）
文中の特定単語をバッククォート ` で囲みます。
`.env` ファイルの `APP_DEBUG` を `true` に設定してください。・複数行のコードブロック（シンタックスハイライト）
バッククォート3つ ``` の後に言語名を指定すると、色鮮やかにシンタックスハイライト表示されます。
```json
{
"status": "success",
"data": {
"taskId": 251,
"taskName": "Backlog Markdown Guide"
}
}
```※指定できる言語例：html, css, javascript, typescript, php, python, ruby, java, sql, bash, yaml, json, markdown など。
👉 コードブロックの言語指定一覧やハイライトの詳細は「Markdownコードブロックの書き方完全ガイド」で解説しています。
⑦ 表（テーブル）の作成と揃え位置
BacklogのMarkdownでは、GFM形式のテーブル記法を使って綺麗な表を作成できます。
| 機能名 | 担当者 | ステータス | 工数(h) |
| :--- | :---: | :---: | ---: |
| DB設計 | 山田 | 完了 | 12.0 |
| API実装 | 佐藤 | 対応中 | 24.0 |
| E2Eテスト | 鈴木 | 未着手 | 8.0 |- 配置揃え（アライメント）：
:---：左揃え（デフォルト・テキスト向け）:---:：中央揃え（ステータス・日付向け）---:：右揃え（数値・工数・金額向け）- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド
- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド
👉 表の作成手順やExcelからの変換テクニックは「Markdown表（テーブル）の書き方完全ガイド」および「Excel・スプレッドシートをMarkdown表に変換する方法完全ガイド」を参考にしてください。
⑧ ハイパーリンク・画像貼り付け
外部サイトのURLや、Backlogに添付したファイルのリンクを整理して記述できます。
[Backlog公式サイト](https://backlog.com/)
※Backlogの課題やWikiの編集画面に画像ファイルをドラッグ＆ドロップすると、添付ファイル専用の画像埋め込みタグが自動生成されます。
⑨ Backlog固有の便利機能（課題キーリンク・メンション・Wiki目次）
Backlogならではの、Markdownとシームレスに連動する独自便利機能です。
| 機能名 | 入力形式 | 効果・動作 |
|---|---|---|
| 課題キーリンク | PROJECT-123 |
文章中に課題キーを書くだけで、自動的にその課題へのリンクとなり、マウスホバーで件名がポップアップ表示されます。 |
| ユーザーメンション | @username |
入力補完から対象者を選択でき、相手にメールやアプリ通知が送信されます。 |
| Wiki目次（TOC） | [toc] または [[TOC]] |
Backlog Wikiの冒頭に記述すると、ページ内の見出し（H1〜H3）から自動で階層化された目次ボックスを生成します。 |
4. 「Backlogでマークダウンが反映されない・効かない」時の6大原因と対処法
「Markdownで書いたはずなのに、課題やコメントで記号がそのまま表示されてしまう…」という場合のチェックリストです。以下の6つのポイントを上から順に確認してください。
原因①：プロジェクトのテキスト整形ルールが「Backlog記法」のまま
最も多い原因です。Backlogのデフォルト設定が「Backlog記法」になっている場合、Markdownの # や ``` は一切装飾として認識されません。
【対処法】 プロジェクト管理者に依頼し、[プロジェクト設定] → [一般] → [テキスト整形のルール] を「Markdown」に変更してもらってください。
原因②：記号が「全角」で入力されている
IMEが日本語入力オンのまま ＃、＊、ー、＞ などの全角記号を入力すると無効になります。
【対処法】 必ず半角英数モードで記号を入力してください。
原因③：記号の直後に「半角スペース」がない
見出しの #見出し やリストの -項目、引用の >引用 のように、記号と文字の間にスペースがないと単なる文字列として扱われます。
【対処法】 # 見出し、- 項目、> 引用 のように必ず直後に半角スペースを入れてください。
原因④：チェックボックスの括弧内に半角スペースがない・ハイフンの後ろにスペースがない
チェックボックスは書式が厳格です。-[ ]（ハイフン後スペースなし）や -[]（括弧内スペースなし）は無効です。
【対処法】 - [ ] （ハイフン＋半角スペース＋角括弧＋半角スペース＋角括弧＋半角スペース）の形式を厳密に守ってください。
原因⑤：表（テーブル）の前後に「空行」がない
Markdownの仕様上、通常の段落テキストと表が直接くっついていると、表としてレンダリングされない場合があります。
【対処法】 表の開始行の前と、表の終了行の後に、必ず1行以上の「空行（改行）」を設けてください。
原因⑥：コードブロックのバッククォートが「シングルクォート」になっている
コードブロックを囲む記号はバッククォート（```：キーボードの Shift + @）ですが、誤ってシングルクォート（'''：Shift + 7）を入力してしまうミスが多発します。
【対処法】 バッククォート ``` を正しく入力してください。
5. 「Backlog記法」と「Markdown記法」の比較｜どちらを選ぶべき？
Backlogの独自フォーマットである「Backlog記法」と、汎用フォーマットの「Markdown記法」にはどのような違いがあるのでしょうか。主要な記法と特徴を比較しました。
| 項目・機能 | Markdown記法（おすすめ） | Backlog記法（従来） | 優位性 |
|---|---|---|---|
| 見出し | # 見出し1## 見出し2 |
* 見出し1** 見出し2 |
Markdown |
| 太字 | **太字** |
''太字''（シングル引用符2つ） |
Markdown |
| 箇条書き | - 項目（* も可） |
- 項目 |
同等 |
| チェックボックス | - [ ] タスク |
非対応（リストのみ） | Markdown圧勝 |
| 表（テーブル） | | 列1 | 列2 | |
|列1|列2|h |
Markdown |
| 他ツール連携 （GitHub/Notion等） |
そのままコピペして相互流用可能 | Backlog専用のため他ツールで崩れる | Markdown圧勝 |
🎯 結論：新規プロジェクトは「Markdown記法」一択！
Backlog記法は古くからの名残で提供されている独自仕様です。GitHubやVS Code、Notion、Teams、ChatGPTなど、現代の開発・業務ツールはほぼすべてMarkdownで統一されています。
「チェックボックスが使える」「他ツールとテキストをコピペしても崩れない」「新しいメンバーへの学習コストがゼロになる」という圧倒的なメリットがあるため、特別な理由がない限りMarkdown記法を選択するのがベストプラクティスです。
6. BacklogのMarkdown利用に関するよくある質問（FAQ）
Q1. プロジェクトごとにBacklog記法とMarkdown記法を混在させることはできますか？
A. プロジェクト単位での設定となるため、「プロジェクトAはMarkdown記法、プロジェクトBはBacklog記法」のようにプロジェクト別で分けることは可能です。ただし、1つのプロジェクト内（同じ課題やWiki内）でBacklog記法とMarkdown記法を部分的に混在させることはできません。
Q2. ユーザー個人の設定で入力記法を切り替えることはできますか？
A. できません。Backlogのテキスト整形のルールはプロジェクト全体の共通設定です。記法を変更したい場合は、プロジェクト管理者に相談してプロジェクト設定を変更してもらう必要があります。
Q3. BacklogのMarkdownで文字色を変更したり蛍光ペン（マーカー）を引くことはできますか？
A. 標準のMarkdown記法には文字色変更の構文はありません。また、BacklogのMarkdownレンダラーではセキュリティ上の理由からインラインCSS（style="color:red;"）などのHTMLタグが無効化（エスケープ）される仕様になっています。重要な箇所を強調したい場合は、太字（**太字**）や引用枠（>）、絵文字（:warning:）を活用して視認性を高めるのがおすすめです。
Q4. スマホアプリ版（iOS / Android）のBacklogでもMarkdownは表示・入力できますか？
A. はい、スマホアプリ版のBacklogでもMarkdown記法で記述された課題やコメント、Wikiを綺麗に閲覧・編集できます。移動中や外出先からでもチェックボックスのON/OFFやコメント返信が手軽に行えます。
7. まとめ｜BacklogのMarkdownを活用して業務連絡・ドキュメント作成を効率化しよう
BacklogでMarkdown記法を活用することで、プロジェクト内のコミュニケーションが劇的にクリアになり、タスクの抜け漏れ防止やドキュメントの資産化を力強く後押ししてくれます。
📝 本記事の重要ポイントまとめ
- 設定の確認： [プロジェクト設定] → [一般] → [テキスト整形のルール] で「Markdown」を選択する。
- 強力なチェックボックス：
- [ ]でWiki閲覧画面から直接クリック可能なタスクリストが作れる。 - コード・表の活用：
```言語名でシンタックスハイライト、|---|で綺麗なテーブル作成。 - Backlog連携： 課題キー（
PROJ-123）やメンション（@user）、Wiki目次（[toc]）も併用可能。 - 反映されない時は： 全角記号の混入、記号直後の半角スペース欠落、表の前後の空行を確認。
- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド
ぜひ本記事のチートシートや書き方を参考に、日々のBacklog運用でMarkdown記法をフル活用してみてください！
📚 あわせて読みたいMarkdown関連記事
- 🔗 【コピペで使える】Markdown記法一覧・チートシート｜基本の書き方から応用・早見表まで完全網羅
- 🔗 【コピペで使える】Markdownチェックボックスの書き方完全ガイド｜VSCode設定・表内の配置・できない時の対処法
- 🔗 【コピペで使える】Markdown表（テーブル）の書き方完全ガイド｜配置揃え・セル結合・改行・便利ツールまで徹底解説
- 🔗 Markdownコードブロックの書き方完全ガイド｜シンタックスハイライト・言語指定一覧
- 🔗 【Googleドキュメント】マークダウン入力・変換の使い方完全ガイド
- 🔗 【Teams】マークダウン記法の使い方完全ガイド｜装飾早見表・反映されない時の対処法＆コピペ術
- 🔗 Slackでマークダウンを活用する方法とおすすめテクニックまとめ
- 🔗 Discordのマークダウン記法一覧｜伏字・ネタバレ・文字色テクニック
- 🔗 NotionでMarkdownを活用する方法！インポート・エクスポート・記法一覧
- 🔗 【コピペで簡単】Excel・スプレッドシートをMarkdown表に変換する方法完全ガイド
- 🔗 【初心者向け】mdファイル（.md）の開き方完全ガイド｜Windows・Mac・ブラウザ・スマホでプレビュー＆編集する手順
- 🔗 【Marp】Markdownでスライド作成！使い方完全ガイド