Confluence サポート

This page describes the XHTML-based format that Confluence uses to store the content of pages, page templates, blueprints, blog posts, and comments. This information is for advanced users who need to interpret or edit the underlying markup of a Confluence page.

We refer to the Confluence storage format as "XHTML-based." Technically, it's XML, since the storage format doesn't fully comply with the XHTML definition. For example, Confluence includes custom elements for macros and other features. We use the term "XHTML-based" to highlight that much of the storage format is similar to HTML.

To view the Confluence storage format for a page, select

その他のオプション

and then View storage format.

On this page:

Storage Format Source Editor

Starting from the version 10.2.3, we’ve bundled Storage Format Source Editor with Confluence.

By default, the Source Editor is disabled for all users, including admins. Admins can open Source Editor Configuration and grant access to specific groups or to all users.

With the Storage Format Source Editor, you can edit the storage format of Confluence pages. Advanced users can review the XHTML source of a page to diagnose and troubleshoot content issues. You can use the Source Editor to:

Edit macro parameters
Update link URLs
Change image names
Fix formatting errors
Search for values and replace them

はじめる前に

When you upgrade to a Confluence version that includes the bundled Storage Format Source Editor app, the upgrade is automatic in most cases. However, keep the following in mind:

If you’re using Storage Format Source Editor versions 19.3.22, 19.3.29, 19.3.30, or 19.5.22, uninstall the app before upgrading your Confluence.
If you uninstall and then reinstall the app, your previous configuration will be restored automatically.
When you upgrade Confluence, any existing Source Editor permissions will carry over to the new version, so your setup won’t be disrupted.

Granting access to the Source Editor

To grant access to the Source Editor, open the Administration menu , and then go to Source Editor Configuration.

Permissions window for the Source Editor in Confluence Administration menu

Using the Source Editor

To open the Source Editor:

Open the Confluence editor. How to use the editor
In the editor toolbar, select the Source Editor icon <>.

The XHTML source of a page will open in the Source Editor.

Source editor window in Confluence

If you select More options, then View source, you'll see the editor panel format, not the storage format of the page.

見出し

形式のタイプ	Confluence 4.0 以降	表示結果
Heading 1	`<h1>Heading 1</h1>`
Heading 2	`<h2>Heading 2</h2>`
Heading 3	`<h3>Heading 3</h3>`

見出し 4 から 6 まで利用でき、同じパターンに従います

テキスト効果

形式のタイプ	Confluence 4.0 以降	表示結果
より強い強調/太字	`<strong>strong text</strong>`	太字
強調	`<em>Italics Text</em>`	強調
取り消し線	`<span style="text-decoration: line-through;"> strikethrough</span>`	~~取り消し線~~
下線	`<u>underline</u>`	下線
上付き	`<sup>superscript</sup>`	^上付き
下付き	`<sub>subscript</sub>`	_下付き
等幅	`<code>monospaced</code>`	`monospaced`
書式設定済み	`<pre>preformatted text</pre>`	書式設定済みテキスト
ブロック引用	`<blockquote> <p>block quote</p> </blockquote>`	ブロック引用
テキスト色	`<span style="color: rgb(255,0,0);">red text </span>`	赤い文字
文字サイズ小	`<small>small text</small>`	小さい文字
文字サイズ大	`<big>big text</big>`	大きい文字
中央揃え	`<p style="text-align: center;">centered text </p>`	中央揃えテキスト
右揃え	`<p style="text-align: right;">right aligned text </p>`	右揃えテキスト

テキストの改行

形式のタイプ	Confluence 4.0 以降	表示結果
新しい段落	`<p>Paragraph 1</p> <p>Paragraph 2</p>`	段落 1 段落 2
改行	`Line 1 <br /> Line 2` 注意: これはエディタで `Shift + Return/Enter` キーを使用して作成したものです	行 1 行 2
水平線	`<hr />`
— 記号	`—`	—
– 記号	`–`	–

形式のタイプ	Confluence 4.0 以降	表示結果
番号なし箇条書き – 黒丸 (Round Bullet)	`<ul> <li>round bullet list item</li> </ul>`	番号なし箇条書き項目
番号付き箇条書き (番号付きリスト)	`<ol> <li>numbered list item</li> </ol>`	番号付き箇条書き項目
タスク一覧	`<ac:task-list> <ac:task> <ac:task-status>incomplete</ac:task-status> <ac:task-body>task list item</ac:task-body> </ac:task> </ac:task-list>`	タスク一覧項目

リンク

形式のタイプ	Confluence 4.0 以降	表示結果
別の Confluence ページにリンク	`<ac:link> <ri:page ri:content-title="Page Title" /> <ac:plain-text-link-body> <![CDATA[Link to another Confluence Page]]> </ac:plain-text-link-body> </ac:link>`	別の Confluence ページにリンク
添付ファイルへのリンク	`<ac:link> <ri:attachment ri:filename="atlassian_logo.gif" /> <ac:plain-text-link-body> <![CDATA[Link to a Confluence Attachment]]> </ac:plain-text-link-body> </ac:link>`	添付ファイルへのリンク
外部サイトにリンク	`<a href="http://www.atlassian.com">Atlassian</a>`	アトラシアン
アンカーリンク (同じページ)	`<ac:link ac:anchor="anchor"> <ac:plain-text-link-body> <![CDATA[Anchor Link]]> </ac:plain-text-link-body> </ac:link>`	アンカーリンク
アンカーリンク (別のページ)	`<ac:link ac:anchor="anchor"> <ri:page ri:content-title="pagetitle"/> <ac:plain-text-link-body> <![CDATA[Anchor Link]]> </ac:plain-text-link-body> </ac:link>`	アンカーリンク
本文の組み込み画像とのリンク	`<ac:link ac:anchor="Anchor Link"> <ac:link-body> <ac:image><ri:url ri:value="http://confluence.atlassian.com/ images/logo/confluence_48_trans.png" /></ac:image> </ac:link-body> </ac:link>` 画像などのリッチコンテンツの場合、 `ac:link-body` を使用してコンテンツを折り返す必要があります。

リンク本体に関する注意

エディタから取得されるすべてのリンクは、既定ではプレーンテキストで保存されます。ただし、リンク本体に含めることを許可されている一部のマークアップが検出された場合はこのかぎりではありません。リンク本体でサポートされているマークアップの例を以下に挙げます。

様々なリンク本体の例

<ac:link>
  <!-- Any resource identifier --> 
  <ri:page ri:content-title="Home" ri:space-key="SANDBOX" /> 
  <ac:link-body>Some <strong>Rich</strong> Text</ac:link-body>
</ac:link>
<ac:link>
  <ri:page ri:content-title="Plugin developer tutorial stuff" ri:space-key="TECHWRITING" />
  <ac:plain-text-link-body><![CDATA[A plain <text> link body]]></ac:plain-text-link-body>
</ac:link>
<ac:link>
  <ri:page ri:content-title="Plugin developer tutorial stuff" ri:space-key="TECHWRITING" />
  <!-- A link body isn't necessary. Auto-generated from the resource identifier for display. --> 
</ac:link>

<ac:link-body> 内で許可されているマークアップタグは、、、、、<code>、<tt>、、、 、 です。

画像

形式のタイプ	Confluence 4.0 以降	表示結果
添付された画像	`<ac:image> <ri:attachment ri:filename= "atlassian_logo.gif" /> </ac:image>`
外部の画像	`<ac:image> <ri:url ri:value="http://confluence.atlassian.com/ images/logo/confluence_48_trans.png" /></ac:image>`

サポートされている画像属性 (これらの属性の一部は、同等の HTML 4 IMG 要素に酷似しています):

名前	説明
ac:align	画像の位置合わせ
ac:border	境界を設定するには "true" に設定します
ac:class	css クラス属性
ac:title	画像のツールチップ
ac:style	css スタイル
ac:thumbnail	この画像をサムネイルとして指定するには "true" に設定します
ac:alt	代替テキスト
ac:height	画像の高さ
ac:width	画像の幅
ac:vspace	画像の上下の空白
ac:hspace	画像の左右の空白

表

形式のタイプ

Confluence 4.0 以降

表示結果

2 列、 2 行 (一番上の見出し行)

<table>

<tbody>
  
<tr>
    
<th>Table Heading Cell 1</th>
    
<th>Table Heading Cell 2</th>
  </tr>
  
<tr>
    
<td>Normal Cell 1</td>
    
<td>Normal Cell 2</td>
  </tr>
</tbody>
</table>

表見出しセル 1	表見出しセル 2
通常のセル 1	通常のセル 2

2 列、3 行。2 行目と 3 行目の最初の列はマージされたセルになります。

<table>

<tbody>
  
<tr>
    
<th>Table Heading Cell 1</th>
    
<th>Table Heading Cell 2</th>
  </tr>
  
<tr>
    
<td rowspan="2">Merged Cell</td>
    
<td>Normal Cell 1</td>
  </tr>
  
<tr>
    
<td colspan="1">Normal Cell 2</td>
  </tr>
</tbody>
</table>

表見出しセル 1	表見出しセル 2
マージされたセル	通常のセル 1
マージされたセル	通常のセル 2

ページレイアウト

Confluence は、マクロベースのレイアウト (セクションや列のマクロの使用など) の代替として、ページレイアウトを直接サポートしています。このセクションでは、これらのレイアウトがページで使用されるときに作成される保存形式 XML について説明します。

要素名 Confluence 5.2 以降属性

ac:layout

ページにレイアウトがあることを示します。ページ内の最上位の要素にします。

なし

ac:layout-section

レイアウト内の行を表します。ac:layout タグに直接含める必要があります。セクションのタイプは、セル数とそれらのセルの相対幅を示します。

ac:type

ac:layout-cell レイアウト内の列を表します。ac:layout-section タグに直接含める必要があります。layout-section 内のセル数は、ac:type に一致する適切な値である必要があります。なし

ac:layout-section の ac:type で認識される値は、次のとおりです。

`ac:type`	期待されるセル数	説明
`single`	1	１つのセルがセクション全体を占有します。
`two_equal`	2	同じ幅の２つのセルです。
`two_left_sidebar`	2	幅が狭い (~30%) セルの後に幅の広いセルが続きます。
`two_right_sidebar`	2	幅の広いセルに幅の狭い (~30%) セルが続きます。
`three_equal`	3	同じ幅の３つのセルです。
`three_with_sidebars`	3	幅の広い 1 つのセルが中央にあり、両端に幅の狭い (~20%) セルがあります。

次の例は、新しい形式に組み込まれた旧形式の少し複雑なレイアウトの 1 つです。{content} は、 または <table> タグなどの他の XHTML または Confluence 保存形式のブロックコンテンツを入力する場所を示しています。

<ac:layout>
  <ac:layout-section ac:type="single">
     <ac:layout-cell>
        {content}
     </ac:layout-cell>
  </ac:layout-section>
 <ac:layout-section ac:type="three_with_sidebars">
     <ac:layout-cell>
       {content}
     </ac:layout-cell>
     <ac:layout-cell>
       {content}
     </ac:layout-cell>
     <ac:layout-cell>
       {content}
     </ac:layout-cell>
  </ac:layout-section>
  <ac:layout-section ac:type="single">
     <ac:layout-cell>
        {content}
     </ac:layout-cell>
  </ac:layout-section>
</ac:layout>

絵文字

形式のタイプ	Confluence 4.0 以降	表示結果
絵文字	`<ac:emoticon ac:name="smile" />`
	`<ac:emoticon ac:name="sad" />`
	`<ac:emoticon ac:name="cheeky" />`
	`<ac:emoticon ac:name="laugh" />`
	`<ac:emoticon ac:name="wink" />`
	`<ac:emoticon ac:name="thumbs-up" />`
	`<ac:emoticon ac:name="thumbs-down" />`
	`<ac:emoticon ac:name="information" />`
	`<ac:emoticon ac:name="tick" />`
	`<ac:emoticon ac:name="cross" />`
	`<ac:emoticon ac:name="warning" />`

リソース識別子

リソース識別子は、保存形式でリソースへの "リンク" または "参照" を表すために使用されます。リソースの例としては、ページ、ブログ投稿、コメント、ショートカット、画像などがあります。

リソース	リソース識別子の形式
ページ	`<ri:page ri:space-key="FOO" ri:content-title="Test Page"/>` メモ: `ri:space-key`: (オプション) スペースキーを示します。これを省略して相対参照を作成することもできます。 `ri:content-title`: (必須) ページのタイトルを示します。
ブログ投稿	`<ri:blog-post ri:space-key="FOO" ri:content-title="First Post" ri:posting-day="2012/01/30" />` メモ: `ri:space-key`: (オプション) スペースキーを示します。これを省略して相対参照を作成することもできます。 `ri:content-title`: (必須) ページのタイトルを示します。 `ri:posting-day`: (必須) 投稿日を示します。形式は、YYYY/MM/DD です。
添付ファイル	`<ri:attachment ri:filename> ... resource identifier for the container of the attachment ... </ri:attachment>` メモ: `ri:filename`: (必須) 添付ファイル名を示します。 `ri:attachment` 要素のボディは、添付ファイルのコンテナを示すリソース識別子にします。これを省略して相対添付ファイル参照 (wiki マークアップの [foo.png] に類似) を作成することもできます。例: 相対添付ファイル参照 `<ri:attachment ri:filename="happy.gif" />` 絶対添付ファイル参照 `<ri:attachment ri:filename="happy.gif"> <ri:page ri:space-key="TST" ri:content-title="Test Page"/> </ri:attachment>`
URL	`<ri:url ri:value="http://example.org/sample.gif"/>` メモ: `ri:value`: (必須) 実際の URL 値を示します。
ショートカット	`<ri:shortcut ri:key="jira" ri:parameter="ABC-123">` メモ: `ri:key`: (必須) Confluence ショートカットのキーを表します。 `ri:parameter`: (必須) Confluence ショートカットに渡すパラメータを表します。上記の例は、Wiki マークアップの `[ABC-123@jira]` に相当します。
ユーザー	`<ri:user ri:userkey="2c9680f7405147ee0140514c26120003"/>` メモ: `ri:userkey`: (必須) ユーザーの一意の識別子を示します。
スペース	`<ri:space ri:space-key="TST"/>` メモ: `ri:space-key`: (必須) スペースのキーを示します。
コンテンツエンティティ	`<ri:content-entity ri:content-id="123"/>` メモ: `ri:content-id`: (必須) コンテンツの ID を示します。

テンプレート変数

次のスクリーンショットは単純なテンプレートを示しています。

テンプレートには次の変数が含まれています。

変数名	タイプ	値
$MyText	単一行テキスト
$MyMulti	複数行テキスト	サイズ: `5 x 100`
$MyList	一覧	リストの項目: `Apples,Pears,Peaches`

XML エクスポートにより、このテンプレート用に次のコードが生成されます。

<at:declarations>
  <at:string at:name="MyText" />
  <at:textarea at:columns="100" at:name="MyMulti" at:rows="5" />
  <at:list at:name="MyList">
    <at:option at:value="Apples" />
    <at:option at:value="Pears" />
    <at:option at:value="Peaches" />
  </at:list>
</at:declarations>


<p>This is Sarah's template</p>

<p>A single-line text variable:&nbsp;<at:var at:name="MyText" /></p>

<p>A multi-line text variable:&nbsp;<at:var at:name="MyMulti" /></p>

<p>A selection list:&nbsp;<at:var at:name="MyList" /></p>

<p>End of page.</p>

説明テキスト

説明テキストを使用すると、エンドユーザー (テンプレートからページの作成を使用する人) 向けにテンプレートの記入方法に関する情報を含めることができます。説明テキストの動作は次のとおりです。

特定のテキストブロックにユーザーが入力すると、すべての 説明テキストが自動でクリアされます。
ユーザーが選択できるように @mention プロンプトが自動でトリガーされます (「mention」タイプの説明テキストの場合)。

スクリーンショット: 説明テキストの例

<ul>
    
<li><ac:placeholder>This is an example of instruction text that will get replaced when a user selects the text and begins typing.</ac:placeholder></li>
</ul>
<ac:task-list>
    <ac:task>
        <ac:task-status>incomplete</ac:task-status>
        <ac:task-body><ac:placeholder ac:type="mention">@mention example. This placeholder will automatically search for a user to mention in the page when the user begins typing.</ac:placeholder></ac:task-body>
    </ac:task>
</ac:task-list>

Confluence サポート

ナレッジベース

製品

Jira Software

Jira Service Management

Jira Work Management

Confluence

Bitbucket

リソース

関連ドキュメント

コミュニティ

提案とバグ

Marketplace

請求とライセンス情報

Confluence ストレージフォーマット

Confluence マークアップ

このページの内容

お困りですか?

Storage Format Source Editor

はじめる前に

Granting access to the Source Editor

Using the Source Editor

見出し

テキスト効果

テキストの改行

リスト

リンク

リンク本体に関する注意

画像

表

ページレイアウト

絵文字

リソース識別子

テンプレート変数

説明テキスト

ページ

Viewport

Confluence

バージョン

Confluence ストレージフォーマット

Confluence マークアップ

このページの内容

関連コンテンツ

お困りですか?

Storage Format Source Editor

はじめる前に

Granting access to the Source Editor

Using the Source Editor

見出し

テキスト効果

テキストの改行

リスト

リンク

リンク本体に関する注意

画像

表

ページレイアウト

絵文字

リソース識別子

テンプレート変数

説明テキスト

関連コンテンツ