【Jira】課題の説明欄で表が崩れる時の入力形式とエディタ確認

Jiraの課題作成画面で、説明欄に表を貼り付けたり手入力したりした際に、列の幅が揃わなかったり、セルがはみ出したり、改行が無視されたりして表が崩れてしまう経験はありませんか。この問題は、使用しているエディタの種類と入力形式(Wikiマークダウン、HTML、リッチテキスト)の組み合わせによって発生しやすくなります。本記事では、表崩れの原因を特定するための確認手順と、正しい入力方法をエディタ別に解説します。

表崩れの主な原因 – 入力形式の違い

Jiraの説明欄で表が崩れる原因は、大きく分けて「入力形式の誤り」と「エディタの互換性問題」の2つです。まずはそれぞれの原因を理解しておきましょう。

WikiマークダウンとHTMLの混在

旧エディタ(Wikiスタイル)では、表を記述するために専用のマークダウン記法を使用します。例えば、パイプ(|)で列を区切り、ハイフン(-)でヘッダーとデータ行を分ける形式です。一方、新エディタ(リッチテキスト)は、ツールバーから表を挿入したり、HTMLを直接貼り付けたりできます。どちらのエディタを使用しているかに関わらず、異なる記法が混在するとJiraが正しく解釈できず、表が崩れる原因となります。典型的な失敗例は、旧エディタでHTMLの<table style=”width:100%;border-collapse:collapse;margin-bottom:1.5em;”>タグを貼り付けてしまい、そのまま表示されるケースです。

セルの区切り文字の問題

Wikiマークダウンで表を記述する際、セル内にパイプ記号(|)や改行が含まれていると、区切り文字として誤認識されて列がずれることがあります。また、セル内で改行をしたい場合に
タグを使用するか、空行を入れるかなどのルールがエディタによって異なります。特に、コピー&ペーストで外部エディタ(ExcelやGoogleスプレッドシート)から表を持ってくると、タブ文字や改行コードが混入して崩れることが多いです。

利用しているエディタの確認方法

自分がどのエディタを使用しているかを知ることが、問題解決の第一歩です。Jiraの課題編集画面で、以下の点を確認してください。

旧エディタ(Wikiスタイル)の特徴

• ツールバーが表示されず、代わりに「プレビュー」タブと「編集」タブが並んでいます。
• 編集エリアはシンプルなテキストフィールドで、記法としてWikiマークダウンを直接入力します。
• 表を挿入するためのボタンはなく、手動でパイプとハイフンを並べて表を作成します。

新エディタ(リッチテキスト)の特徴

• 画面上部に太字、斜体、箇条書き、表挿入などのリッチテキストツールバーが表示されます。
• 「プレビュー」タブはなく、編集画面がWYSIWYG形式で表示されます。
• 「Insert」メニューから「Table」を選ぶと、グリッドで行数・列数を指定して表を挿入できます。

エディタの切り替え設定

プロジェクトやシステム全体で使用するエディタを切り替えるには、Jira管理者が管理画面から設定を変更する必要があります。個人設定で切り替えられる場合もありますが、一般的にはプロジェクト設定で「Default text editor」を変更します。もしエディタを切り替えたいが権限がない場合は、管理者に依頼してください。

表崩れを防ぐ正しい入力方法(エディタ別)

エディタごとに適切な入力形式を以下にまとめます。

エディタの種類	正しい表の記述方法	注意点
旧エディタ(Wiki)	||ヘッダ1||ヘッダ2|| |セル1|セル2|	ヘッダ行はパイプ2本(||)で囲みます。データ行はパイプ1本(|)で区切ります。セル内にパイプを使いたい場合はエスケープ(バックスラッシュ)を使用します。
新エディタ(リッチ)	ツールバーの「表」ボタンで挿入するか、またはHTMLの<table>タグを直接貼り付ける。	HTMLを貼り付ける場合は、Jiraが許可するタグ(<table>, <tr>, <td>, <th>など)のみを使用します。スタイル属性(width, borderなど)は一部サポートされますが、複雑なCSSは無視されることがあります。

旧エディタで表を作成する手順を以下に示します。

1. 説明欄の編集エリアにカーソルを置き、Wikiマークダウンで表を記述します。最初の行にヘッダーを記述する場合は、パイプを2本続けて(||)で囲みます。
2. データ行はパイプ1本(|)でセルを区切り、行末にはパイプを付けなくてもかまいません。
3. 表の列数を揃えるため、各行で同じ数のパイプを使用してください。列数が異なると崩れます。
4. セル内で改行したい場合は、改行コードではなく<br>タグを使用します。ただし、旧エディタでは<br>がそのまま表示される場合があるため、代わりに空行(パイプなしの改行)を挿入して擬似的に行を分けることもできます。
5. 記述が完了したら、「プレビュー」タブをクリックして表が正しく表示されるか確認します。問題があれば修正してください。

よくある失敗パターンと対処法

実際に多くのユーザーが遭遇する失敗パターンをいくつか紹介します。

• Excelからコピーした表が崩れる
  ExcelやGoogleスプレッドシートからセルをコピーしてJiraの説明欄に貼り付けると、タブ区切りや改行がそのまま反映され、表として認識されないことがあります。新エディタではHTMLに変換されて貼り付けられる場合もありますが、旧エディタでは単なるテキストとして扱われます。対処法として、貼り付け前にメモ帳などに一度貼り付けてプレーンテキストにし、パイプ記号を手動で追加してください。
• Wikiマークダウンで書いた表がプレビューで崩れる
  パイプの数が足りなかったり、余分なスペースが入っていたりすると崩れます。また、ヘッダ行とデータ行の間にハイフンによる区切り線を入れなければならないと思い込んでいる方もいますが、JiraのWiki記法ではハイフン行は不要です(通常のマークダウンとは異なります)。
• HTMLタグで書いた表がそのまま表示される
  旧エディタではHTMLタグはエスケープされて表示されます。新エディタでも、許可されていないタグ(例:<div>や<span>)は無視または削除されることがあります。正しいタグを使っているか確認しましょう。

管理者に確認すべき設定項目

表崩れが組織全体で発生している場合、管理者側の設定が原因かもしれません。以下の項目を管理者に確認してください。

• 使用しているエディタの種類:システム全体で旧エディタと新エディタのどちらが有効になっているか確認します。プロジェクトごとに異なる場合もあるため、対象プロジェクトの設定も調べます。
• HTMLサンドボックス設定:Jiraではセキュリティのため、説明欄で使用できるHTMLタグが制限されています。許可リストに<table>タグが含まれているか、また属性(colspan, rowspanなど)が許可されているかを確認します。
• アドオンやプラグインの影響:表作成を支援するアドオン(例えば「Table Formatter」など)がインストールされている場合、それが競合して崩れることがあります。該当するアドオンを一時的に無効にして動作を確認します。
• ブラウザのキャッシュ:まれにブラウザのキャッシュが原因でエディタの表示が正しく動作しないことがあります。管理者に確認する前に、シークレットモードや別のブラウザで試してみてください。

よくある質問

Q. 旧エディタと新エディタ、どちらを使うべきですか?
A. 表を頻繁に作成するなら新エディタの方が直感的で崩れにくいです。ただし、旧エディタに慣れているチームでは、Wikiマークダウンを統一ルールとして使うこともあります。会社の標準に従ってください。

Q. 表のセル内で改行したいのですが、どうすればいいですか?
A. 新エディタでは、セル内でEnterキーを押すと自動的に改行(<br>)が挿入されます。旧エディタでは、<br>を直接入力するか、空行を挟んで別の行として扱う方法もあります(ただし同じセル内の改行にはなりません)。

Q. 貼り付けた表の列幅を調整できますか?
A. Jiraでは表の列幅を直接指定することはできません。列幅は内容に合わせて自動調整されます。どうしても固定したい場合は、HTMLでwidth属性を指定してみてください(新エディタのみ)。

まとめ

Jiraの課題説明欄で表が崩れる問題は、使用しているエディタの種類と入力形式を正しく理解することで大半は解決できます。まずは自分が旧エディタ(Wiki)か新エディタ(リッチテキスト)かを確認し、それぞれに合った記述方法を選択してください。外部からコピーした表はプレーンテキストに変換してから貼り付けると失敗が減ります。組織全体で頻発する場合は、管理者と協力してエディタの設定やHTML許可リストを見直しましょう。