Redmineで画像のサイズを指定するには、Textile記法で!{width:640px}image.png!のように画像名の前へ幅を書きます。
2枚を横に並べるときは、表の1行に|!{width:320px}a.jpg!|!{width:320px}b.jpg!|と書きます。
この記事では、RedmineのWikiで使うTextile記法を、画像・表・見出し・マクロに分けてまとめます。
最初に編集画面の書式ヘルプで、利用中の書式を確認してください。
2026年10月24日に公式資料と本文の構文を照合しました。
利用中のRedmineでの描画や保存後の表示は未検証です。
よく使う記法チートシート（コピペ用）
Textile 記法を選択した環境での書き方です。公式の記法ページで確認できる構文だけを並べています。
| やりたいこと | 書き方 |
|---|---|
| 見出し | h1. ページ見出し / h2. 大見出し / h3. 小見出し （行頭に書く） |
| 目次（左寄せ） | {{toc}} |
| 目次（右寄せ） | {{>toc}} |
| 添付画像をそのまま表示 | !image.png! |
| 画像の幅をpxで指定 | !{width:640px}image.png! |
| 画像の幅を%で指定（はみ出し対策） | !{width:100%}image.png! |
| 画像を右に回り込ませる | !>image.png! |
| 画像にタイトルを付ける | !image.png(タイトル)! |
| クリックで拡大するサムネイル | {{thumbnail(image.png, size=300, title=拡大)}} |
| 長文を折りたたむ | |
| 他ページを読み込む | {{include(ページ名)}} |
| 別プロジェクトのページを読み込む | {{include(プロジェクト識別子:ページ名)}} |
| 子ページの一覧 | {{child_pages}} / 階層を2段に {{child_pages(depth=2)}} |
| チケットへのリンク（件名付き） | {{issue(123)}} |
| 水平線 | ---- |
| 引用 | bq. 引用する本文 （行頭に書く） |
| 赤文字 | %{color:red}赤文字% |
| 蛍光ペン | %{background-color: #ffff00}蛍光ペン% |
出典は Redmine 公式の RedmineTextFormattingTextile です。
RedmineのWikiでよくつかう記法
Textileの本文書式に、Redmineのリンク記法やマクロを組み合わせます。
見出し
h1. ページ見出し
行頭のh1.の後に半角スペースと見出し本文を書きます。
Wikiページ名そのものを変更する操作ではありません。
h2. 大見出し
大見出し
h3. 小見出し
小見出し
この3つで十分。
目次
{{toc}}
そのページの構成がひと目でわかります。
画像
!{width:640px}image.jpg!
画像のサイズは固定にします。
よく使うので単語登録。
並列に画像を複数並べる
|!{width:320px}a.jpg!|!{width:320px}b.jpg!|
表の1行2セルへ画像を入れる例です。
区切りは各境界に1本の縦棒を使います。
幅320pxの画像2枚でも狭い画面でははみ出す場合があるため、プレビューで確認してください。
水平線
----
一旦、仕切りたい時に。
リンク
"Redmine.JP":http://redmine.jp/
リポジトリのリンク
source:trunk ／ 特定リビジョンの例：source:trunk@52
リポジトリ内のファイルやディレクトリーにはsource:を使います。
パス・リビジョン・ブランチの指定は登録済みリポジトリに合わせてください。
URLの一部を削れば常に最新になるとは限りません。
テーブル
Wikiのテーブルに色を付ける方法
table{background:#F5F5F5}.
{background:#666666}. |_. %{color:white}親フォルダ%|_. %{color:white}子フォルダ%|_. %{color:white}備考% |_. %{color:white}発注%|_. %{color:white}制作%|
|/4=. TEST |=.A |. -|/2=. - |/2=. -|
|=.B |. - |
|=.C |. - |=. - |=. -|
|=.D |. - |=. - |=. -|1行目の table{background:#F5F5F5}. で、表全体に背景色を付けています。
表の書き方と背景色の指定は、下の「表（テーブル）の書き方と背景色の指定」で詳しく説明します。
引用
bq. 引用する本文
折りたたむ
長文を隠したい時に
{{collapse
あいうえお
}}赤文字
%{color:red}赤文字%
蛍光ペン
%{background-color: #ffff00}蛍光ペン%
蛍光ペン風の強調表示
箇条書き項目
行頭の記号と半角スペースで箇条書きを作ります。
アスタリスクを2つにすると下位の階層になります。
太字を指定するHTMLタグの違いではありません。
第1階層の例
* 親項目
直前の親項目に続けて書く第2階層の例
** 子項目
表（テーブル）の書き方と背景色の指定
Redmineの表は、TextileとMarkdownで書き方が違います。
2026年11月8日に、Redmine公式の記法ページで書式を確かめました。
当方では、利用中のRedmineで表示までは確かめていません。
Textileで表を書く
セルを縦棒 | で区切り、1行を表の1行として書きます。
見出しのセルにするときは、セルの先頭に _. を付けます。
|_. 作業 |_. 担当 |_. 状態 |
| 設計 | 田中 | 完了 |
| 実装 | 佐藤 | 作業中 |セルの結合と文字の寄せ（Textile）
セルの先頭に記号を付けると、結合や寄せを指定できます。
| 記号 | 意味 | 書き方の例 |
|---|---|---|
_. | 見出しのセル | |_. 作業 | |
\2. | 横に2セル結合 | |\2. 横に結合 | |
/2. | 縦に2セル結合 | |/2. 縦に結合 | |
<. | 左寄せ | |<. 左 | |
=. | 中央寄せ | |=. 中央 | |
>. | 右寄せ | |>. 右 | |
^. | 上寄せ | |^. 上 | |
~. | 下寄せ | |~. 下 | |
縦棒と記号のあいだには、何も入れません。
記号を組み合わせるときは、見出し、結合、寄せの順に書き、最後に . を付けます。
公式ページには、順番が違うと記号として読まれないと書かれています。
セルの中に縦棒そのものを書くときは、<notextile>|</notextile> と書きます。
セルと表に背景色を付ける（Textile）
Textileでは、CSSの書き方を波かっこに入れて、セルや表に色を付けます。
下は公式ページの例で、1列目のセルに幅と背景色を指定しています。
table{width: 100%}.
|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |セルの先頭の = は中央寄せで、その後ろに {…} と . を続けます。
表全体の幅や色は、表の直前の行に table{width:100%}. の形で書きます。
table の行の前には空行が必要で、その行と表のあいだには空行も文字も入れません。
使えるCSSのプロパティは決まっていて、背景の background と background-* は許可されています。
文字色の color、枠線の border、幅の width なども使えます。
一覧にないプロパティは、安全のために使えないと公式ページに書かれています。
出典はRedmine公式のRedmineTextFormattingTextileです。
Markdown（CommonMark）で表を書く
Markdownでは、1行目を見出しにして、2行目に |---| の区切りの行を入れます。
| 作業 | 担当 | 件数 |
|:-----|:----:|-----:|
| 設計 | 田中 | 3 |
| 実装 | 佐藤 | 12 |区切りの行のコロンの位置で、寄せが決まります。
左だけなら左寄せ、両側なら中央寄せ、右だけなら右寄せです。
この書き方は、redmine.orgのRedmineTextFormattingMarkdownに載っています。
RedmineのCommonMark Markdownの書式ヘルプには表の節が無く、GitHub Flavored Markdownの拡張に対応していると書かれています。
GitHub Flavored Markdownの仕様でも、表は見出しの行・区切りの行・データの行で作ります。
この仕様の表の節には、セルの結合や背景色を指定する書き方は出てきません。
Markdown（CommonMark）でセルに背景色を付ける
Redmine 6.1と7.0のCommonMark Markdownの書式ヘルプには、結合のある複雑な表はHTMLで直接書けると書かれています。
HTMLで書くときは style 属性が使え、許可された一覧に background-color も入っています。
下は公式の例に背景色を足したもので、当方では表示を確かめていません。
<table width="50%">
<tr><td rowspan="2" style="background-color:#ffff99">Two rows</td><td>foo</td></tr>
<tr><td>bar</td></tr>
<tr><td align="center" colspan="2">bar</td></tr>
</table>古い書式のMarkdownについては、redmine.orgの記法ページに、HTMLタグは既定で許可されていないと書かれています。
同じMarkdownでも書式によって扱いが違うので、［管理］→［設定］のテキスト書式で、どちらが選ばれているかを確かめてください。
画像のサイズ指定と並べ方
Wikiに添付した画像は、ファイル名だけで本文に出せます。
そのままだと元のサイズで出るので、幅を指定して揃えるのが基本です。
| やりたいこと | 書き方 |
|---|---|
| 添付した画像を表示する | !image.png! |
| 幅を指定する | !{width:640px}image.png! |
| 親の幅いっぱいに広げる | !{width: 100%}image.png! |
| 右に回り込ませる | !>image.png! |
| altとタイトルを付ける | !image.png(説明文)! |
| 画像にリンクを付ける | !image.png!:https://example.com |
| 横に並べる | |!{width:320px}a.png!|!{width:320px}b.png!| |
幅の指定はCSSと同じ書き方なので、pxでも%でも通ります。
width: 100%にすると、置いた場所の幅に合わせて伸び縮みします。
クリックで拡大できるサムネイルにする
一覧に小さく並べて、必要な人だけ拡大して見てもらいたい場合があります。
その場合はサムネイルのマクロを使います。
| 書き方 | 内容 |
|---|---|
{{thumbnail(image.png)}} | サムネイルで表示する。既定の大きさは200ピクセル |
{{thumbnail(image.png, size=300, title=説明)}} | 大きさとタイトルを指定する |
サムネイルはクリックすると元の画像が開きます。
手順書のように画像が多いページでは、縦に長くならずに済みます。
添付した画像をクリックで拡大できるサムネイルにします。引数を省略すると200ピクセルで表示されます。
{{thumbnail(image.png)}}大きさとマウスオーバー時のタイトルを指定する場合は、size と title を付けます。
{{thumbnail(image.png, size=300, title=Thumbnail)}}公式の記法ページでは、{{thumbnail(image.png)}} が既定200ピクセル、{{thumbnail(image.png, size=300, title=Thumbnail)}} が大きさとタイトルを指定する形として記載されています（RedmineTextFormattingTextile）。画像はそのページに添付されている必要があります。
ページをまたいで使うマクロ
ページが増えてくると、同じ内容を何度も書くことになります。
Redmineには、それを避けるためのマクロがあります。
| 書き方 | 内容 |
|---|---|
{{include(ページ名)}} | 別のWikiページの内容をそのまま読み込む |
{{include(プロジェクト識別子:ページ名)}} | 別プロジェクトのページを読み込む |
{{child_pages}} | そのページの子ページを一覧にする |
{{child_pages(ページ名, parent=1)}} | 指定したページの子を、親へのリンク付きで一覧にする |
共通の注意事項を1ページにまとめて、各ページから読み込む使い方が便利です。
直すときも、読み込み元の1ページだけ直せば済みます。
書式の種類やRedmineの版によって対応が異なります。
特に古い書式のMarkdownでは生HTMLが既定で許可されないと公式ページに記載されているため、imgタグによるサイズ指定を共通手順として扱わないでください。
仕事が捗るほかのツールは、まとめからご覧いただけます。
この記事で紹介しているコードは、GitHubのMOTOKI-LLC/cg-method-codeにもまとめています。
仕事で使うWebサービスの記事は、ほかにもあります。
共通の注意書きや環境情報を1ページにまとめ、各ページから読み込むと更新漏れが減ります。
{{include(ページ名)}}別プロジェクトの Wiki から読み込むときは、プロジェクトの識別子を付けます。
{{include(プロジェクト識別子:ページ名)}}マニュアルの目次ページには、子ページの一覧を自動生成するマクロが便利です。
{{child_pages}}
{{child_pages(depth=2)}}
{{child_pages(Foo)}}depth=2 は2階層までの表示、{{child_pages(Foo)}} は別ページ Foo の子ページ一覧です（RedmineTextFormattingTextile）。
注意：Textile 記法と Markdown 記法で書き方が変わるもの
Redmine のテキスト書式は Textile と Markdown を選べます。本記事の画像・文字装飾の構文は Textile 向けです。Markdown に設定されている場合、画像や表の書き方が変わります。
| やりたいこと | Textile | Markdown |
|---|---|---|
| 添付画像の表示 | !image.png! |  |
| 幅を指定 | !{width:100%}image.png! | HTMLのimg記法が許可されるかは書式エンジン・設定次第。通常のMarkdown画像記法だけでは幅指定を共通化できない |
| 表 | |見出し|見出し|（|_. で見出しセル） | |見出し|見出し| の下に |---|---| の行が必要 |
一方で {{toc}}、{{collapse}}、{{include}}、{{thumbnail}}、{{child_pages}} といったマクロは、公式の Markdown 記法ページにも同じ形で記載されています（RedmineTextFormattingMarkdown）。{{toc}} は公式のTextile・Markdown説明ともに前後に空行が必要で、同じ行に他の文字を置かない点が明記されています。
自分の環境の設定は、Wiki の編集画面にある書式のヘルプ（リンク先が Textile か Markdown のどちらの説明になっているか）で見分けられます。管理権限があれば［管理］→［設定］のテキスト書式の項目で確認できます。
書式と添付画像を確認する順番
Wikiを書くときの、おおまかな順番です。
内容は、このページの説明にもとづく目安です。
記法はRedmineの設定やバージョンによって異なります。
このページはTextile記法を選択した環境の書き方です。
お使いのRedmineで、書式の設定を確認してください。
- まず、お使いのRedmineの書式が、Textile記法か、Markdown記法かを確認する。ページ末尾の「Textile 記法と Markdown 記法で書き方が変わるもの」も参照する。
- 見出しと目次から整える。見出しは行頭に書き、目次は専用のマクロで入れる。
- 画像を使う場合は、まず、そのページに画像を添付する。ファイル名だけで本文に出せる。
- 画像が大きすぎる場合は、幅を指定して揃える。幅はCSSと同じ書き方で、pxでも%でも指定できる。
- 画像が多いページでは、クリックで拡大できるサムネイルのマクロを使うと、縦に長くならずに済む。
- 同じ内容を何度も書く場合は、ページをまたいで使うマクロを使う。
書いたあとは、プレビューで表示を確認してから保存してください。
よくある質問：RedmineのWiki記法で迷ったときのチェックリスト
Redmineの記法は、Textileですか？Markdownですか？
このページでは、Textile記法を選択した環境での書き方を紹介しています。
公式の記法ページで確認できる構文だけを並べています。
お使いのRedmineの設定によって、使える記法が異なります。
画像のサイズは、どう指定しますか？
幅を指定して揃えるのが基本です。
幅の指定はCSSと同じ書き方で、pxでも%でも通ります。
100%にすると、置いた場所の幅に合わせて伸び縮みします。
画像を右に回り込ませたり、横に並べたりできますか？
できます。
ページの「画像のサイズ指定と並べ方」の表で、書き方を紹介しています。
サムネイルを使うには？
サムネイルのマクロを使います。
引数を省略すると、200ピクセルで表示されます。
大きさとマウスオーバー時のタイトルを指定することもできます。
画像は、そのページに添付されている必要があります。
画像が表示されないときは？
画像がそのページに添付されているかを確認します。
サムネイルのマクロも、画像はそのページに添付されている必要があります。
表のセルに背景色を付けるには？
Textileでは、公式ページの例の |={width: 30%; background-color: #aaf;}. column 1 | のように、セルの先頭にCSSを書きます。
CommonMark Markdownでは、HTMLの表を書いて style 属性で背景色を指定します。
ページをまたいで使えるマクロは？
ページが増えてきて、同じ内容を何度も書くことになるときに使います。
ページ内の「ページをまたいで使うマクロ」の表で紹介しています。
