'(吹 き 出 し)') ([参考](https://github.com/Orc/discount/issues/260))
}}
//VS Code 1.63.2 では「()で挟んだ吹き出し」は 有効、"",'',()のいずれにも挟まれていない文字列が()内に入っている場合はその構文はリンクとはみなされず、通常の文字列となり、オートリンクが有効な場合にはURLのみリンクとなります。
ちなみに、Wikiでは存在するページ（例えば Help、FrontPage、Menuなど）へのリンクが自動的に生成されます。
{{markdown
しかしながら、Markdownブロック内では、Wikiページ（例えば Help、FrontPage、Menuなど）へのリンクは自動生成されません。
}}
{{markdown
しかしながら、Markdownブロック内では、Wikiページ（例えば Help、FrontPage、Menuなど）へのリンクは自動生成されません。
}}
!!! 内部リンク
!! (#見出し)形式での内部リンク [[*1|#p2]][[*2|#p2]][[*3|#p2]][[*4|#p2]]
以下の(#見出し)形式での内部リンクでは、『本ページのURLの後ろに「URLエンコードされた"#見出し"」が付けられた URL』へリンクが張られます。
""なお、プレビュー時には引数(?より右側)が取り除かれたURLに「URLエンコードされた"#見出し"」が付けられた URLへリンクが張られます。また、[[*1|#p2]]の環境では「URLエンコード」は行われません。
- [見出しへの内部リンク（吹き出し無）](#見出し)
- [見出しへの内部リンク（吹き出し有）](#見出し "吹き出し")
{{markdown
- [見出しへの内部リンク（吹き出し無）](#見出し)
- [見出しへの内部リンク（吹き出し有）](#見出し "吹き出し")
}}
しかしながら、[[*1|#p2]][[*2|#p2]][[*3|#p2]][[*4|#p2]]の環境では、リンクに対応するアンカータグが付けられていないため、リンクをクリックしても「見出し」へは移動しません。この問題は以下の節の対応を行うことで解決できます。
!! FSWikiの見出しへのリンク (ページ名と見出し番号の指定)
FSWikiの1番目の見出には 、2番目の見出には 、n番目の見出には のアンカータグが付けられているため、それを内部リンク構文 [任意のメッセージ](#anchor name) の # の後ろに指定します。また、ページ名を指定する場合は、# の前に「wiki.cgi?page=ページ名」を付けます。
- [3番目のFSWikiの見出しへのリンク（ページ名無）](#p2 "ページ名無")
- [Help/Markdownページの4番目のFSWikiの見出しへのリンク（URLコーディング無）](wiki.cgi?page=Help/Markdown#p3 "URLコーディング無")
- [Help/Markdownページの5番目FSWikiのの見出しへのリンク（URLコーディングで記述）](wiki.cgi?page=Help%2FMarkdown#p4 'URLコーディングで記述')
{{markdown
- [3番目のFSWikiの見出しへのリンク（ページ名無）](#p2 "ページ名無")
- [Help/Markdownページの4番目のFSWikiの見出しへのリンク（URLコーディング無）](wiki.cgi?page=Help/Markdown#p3 "URLコーディング無")
- [Help/Markdownページの5番目のFSWikiの見出しへのリンク（URLコーディングで記述）](wiki.cgi?page=Help%2FMarkdown#p4 'URLコーディングで記述')
}}
!! Markdownブロック内の見出しへのリンク (アンカータグの付与)
「Markdownブロック内の見出し」にアンカータグ を付け、そこで指定した "anchor name" を内部リンク構文 [任意のメッセージ](#anchor name) の # の後ろに指定します。
{{markdown
#### Markdownブロック内の見出し
- [「Markdownブロック内の見出し」へのリンク](#Markdownブロック内の見出し)
- [Help/Markdownページの「Markdownブロック内の見出し」へのリンク](wiki.cgi?page=Help/Markdown#Markdownブロック内の見出し)
#### Anchored Markdown Header
- [Link to "Anchored Markdown Header" (with bubble)](#anchored-markdown-header "speech bubble")
}}
{{markdown
#### Markdownブロック内の見出し
- [「Markdownブロック内の見出し」へのリンク](#Markdownブロック内の見出し)
- [Help/Markdownページの「Markdownブロック内の見出し」へのリンク](wiki.cgi?page=Help/Markdown#Markdownブロック内の見出し)
#### Anchored Markdown Header
- [Link to "Anchored Markdown Header" (with bubble)](#anchored-markdown-header "speech bubble")
}}
なお、
* "anchor name" を見出しと同じ文字列(ただし、見出しに半角スペースが含まれる場合にはそれらをハイフン「-」に変換し、大文字は小文字に変換した)文字列にしておけば他の Markdown 実装との互換性を保てます。
* "anchor name"が Non-ASCII の場合には、いくつかのブラウザ(Chrome 105, Edge 105など)ではアンカータグに移動しないようです(Firefox 105 では移動しました)。
!!! 集約リンク
同じリンク先を繰り返し利用する場合は、リンク先を [ラベル]: の後ろに記述し、[ラベル]または[表示名][ラベル]でリンクを張ります。
{{markdown
- [FSWiki URL]による[FSWiki URL]のための[FSWikiのURL][FSWiki URL]。
- [fswiki git repo], [git repository][fswiki git repo], [git clone][fswiki git repo].
- 「表示名」には[[1]][FSWiki URL]のように角括弧「[]」を含めることが可能です。
- 吹き出しは()で囲むことも可能です。[FSWiki URL ()で挟んだ吹き出し]
[fswiki git repo]: https://osdn.net/projects/fswiki/scm/git/fswiki/ '吹き出し'
[FSWiki URL]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi "吹き出し"
[FSWiki URL ()で挟んだ吹き出し]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi (吹き出し)
}}
{{markdown
- [FSWiki URL]による[FSWiki URL]のための[FSWikiのURL][FSWiki URL]。
- [fswiki git repo], [git repository][fswiki git repo], [git clone][fswiki git repo].
- 「表示名」には[[1]][FSWiki URL]のように角括弧「[]」を含めることが可能です。
- 吹き出しは()で囲むことも可能です。[FSWiki URL ()で挟んだ吹き出し]
[fswiki git repo]: https://osdn.net/projects/fswiki/scm/git/fswiki/ '吹き出し'
[FSWiki URL]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi "吹き出し"
[FSWiki URL ()で挟んだ吹き出し]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi (吹き出し)
}}
{{markdown
- しかしながら、参照先の「ラベル」に「[[角括弧挟みラベル]]」のように角括弧「[]」を含めるとラベルでなく通常の文字列と見なされます。
- 参照する側の「通常のラベル」を「[[通常のラベル]]」のように角括弧「[]」で挟むことは可能です。
[[角括弧挟みラベル]]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi "この行はリンク先の定義ではなく通常の文字列と見なされます。"
[通常のラベル]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi "この行はリンク先の定義と見なされます。"
}}
{{markdown
- しかしながら、参照先の「ラベル」に「[[角括弧挟みラベル]]」のように角括弧「[]」を含めるとラベルでなく通常の文字列と見なされます。
- 参照する側の「通常のラベル」を「[[通常のラベル]]」のように角括弧「[]」で挟むことは可能です。
[[角括弧挟みラベル]]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi "この行はリンク先の定義ではなく通常の文字列と見なされます。"
[通常のラベル]: https://fswiki.osdn.jp/cgi-bin/wiki.cgi "この行はリンク先の定義と見なされます。"
}}
!!! 注釈 拡張構文 [[*1|#p2]][[*2|#p2]][[*3|#p2]][[*4|#p2]]
//Visual Studio Code でも未対応
注釈される文書。[^1]
[^1]: 注釈文。
{{markdown
注釈される文書。[^1]
[^1]: 注釈文。
}}
!!! 画像
外部のWebサーバの画像を表示させる場合は、Webサーバの設定で Content-Security-Policy (CSP) の img-src にそのサーバのURLを追加する必要があります。
- 
- 
// - 
// - 
{{markdown
- 
- 
}}
!! サイズ指定画像
! HTML tag
-
{{markdown
-
}}
! Discount 拡張構文
URL の後ろに '=widthxheight' を付けることで画像サイズを変更できます。
- 
- 
{{markdown
- 
- 
}}
!!! コメント
{{markdown
}}
!!! 水平線
スペースとタブを無視して「-」、「_」、「*」のいずれかの記号が３個以上連続する行は水平線になります。
（ただし、行頭が4スペース以上開くとコードブロックと解釈されます。）
---
-----
- - -
- - -
{{markdown
---
----
- - -
- - -
}}
(以下は三重下線)
___
(以下は四重下線)
____
_ _ _
_ _ _
{{markdown
(以下は三重下線)
___
(以下は四重下線)
____
_ _ _
_ _ _
}}
***
****
* * *
* * *
{{markdown
***
****
* * *
* * *
}}
!!! テーブル 拡張構文 [[*1|#p2]]
| 左寄せ列 | 中央寄せ列 | 右寄せ列 |
|:---------|:----------:|---------:|
| 1-1 | 1-2 | 1-3 |
| 2-1 | 2-2 | 2-3 |
中央寄せ、右寄せが有効になっていない場合は、以下の節の注意点をご参照下さい。
{{markdown
| 左寄せ列 | 中央寄せ列 | 右寄せ列 |
|:---------|:----------:|---------:|
| 1-1 | 1-2 | 1-3 |
| 2-1 | 2-2 | 2-3 |
}}
!! Discount/PHP 拡張構文
左寄せ列 | 中央寄せ列 | 右寄せ列
:--------|:----------:|---------:
1-1 | 1-2 | 1-3
2-1 | 2-2 | 2-3
中央寄せ、右寄せが有効になっていない場合は、以下の節の注意点をご参照下さい。
{{markdown
左寄せ列 | 中央寄せ列 | 右寄せ列
:--------|:----------:|---------:
1-1 | 1-2 | 1-3
2-1 | 2-2 | 2-3
}}
!! 中央寄せ Discount 拡張構文
中央寄せが有効になっていない場合は、以下の節の注意点をご参照下さい。
->中央寄せ<-
{{markdown
->中央寄せ<-
}}
!! 左寄せ、中央寄せ、右寄せを有効にする際の注意点
[[*2|#p2]][[*3|#p2]][[*4|#p2]]の環境はテーブル表示に対応しているのですが、中央寄せ、右寄せのスタイルが以下のようにインラインで出力されます。
左寄せ列 |
中央寄せ列 |
右寄せ列 |
CSPを無効にしたり、CSPの style-src に "unsafe-inline" を指定することで中央寄せ、右寄せで表示されるようになるのですが、この方法は任意のインラインスタイルも有効にするためセキュリティ上'''非推奨'''となります。
セキュリティ的に理想的な対応は、インラインスタイルを用いず、スタイルシートで実現できるように Markdown to HTML Converter (Discountなど)を修正し、それに対応するスタイルシートを参照することになります。
例えば、スタイルシートで以下のような text-align: を定義しておき、
.text-left {
text-align: left !important;
}
.text-right {
text-align: right !important;
}
/* https://raw.githubusercontent.com/twbs/bootstrap/main/dist/css/bootstrap.css */
.text-center {
text-align: center !important;
}
HTMLのthタグとtdタグがそれぞれ以下のように出力されるように Markdown to HTML Converter (Discountなど)を修正します。
左寄せ列 |
中央寄せ列 |
右寄せ列 |
1-1 |
1-2 |
1-3 |
しかしながら、この修正は Markdown to HTML Converter とスタイルシートの両方を修正する必要があります。
汎用的かつ暫定的な妥協策としては CSPの style-src に 'unsafe-hashes' と、上記のインラインスタイルのハッシュ値を追加するという方法があります。具体的には、[httpd-security-fswiki-local.conf|https://raw.githubusercontent.com/KazKobara/dockerfile_fswiki_local/main/data/httpd-security-fswiki-local.conf] の Next-recommended CSP のような設定を有効にします。
!!! 整形済テキスト 拡張構文
// Fenced Code Block / Code Snippet
// インデント無しでの整形済テキストは、FSWikiLite だと[preプラグイン|https://fswiki.osdn.jp/cgi-bin/wiki.cgi/docs?page=FSWikiLite%2Freadme#p3]で実現できます。LiteでないFSWikiには入っていないようです。
!! 文書中のコード
同じ長さのバッククオートで挟まれた箇所は、そのまま表示されます。
{{markdown
Markdownブロック内の文章：
挟まれていない場合「© < _イタリック_」は変換されます。
挟まれている場合「`© < _イタリック_`」は変換されません。
}}
{{markdown
Markdownブロック内の文章：
挟まれていない場合「© < _イタリック_」は変換されます。
挟まれている場合「`© < _イタリック_`」は変換されません。
}}
! 連続するバッククオートをコードブロック内に含める場合
それより長いバッククオートで挟みます。
{{markdown
Markdownブロック内の文章：
挟まれていない場合「```鍵括弧内のバッククオートは表示されません。```」、
挟まれている場合````「```鍵括弧内のバッククオートは表示されます。```」````。
}}
{{markdown
Markdownブロック内の文章：
挟まれていない場合「```鍵括弧内のバッククオートは表示されません。```」、
挟まれている場合````「```鍵括弧内のバッククオートは表示されます。```」````。
}}
!! コードブロック(三重バッククオート上下挟み) [[*1|#p2]][[*2|#p2]]
// Github-flavored
[[*1|#p2]][[*2|#p2]]の環境では、文書中（インライン）のコードとして解釈され、
改行は半角スペースに変換されます。
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
```shell
echo "１行目。コードブロック内では「© < _イタリック_」は変換されません。"
echo "２行目。コードブロック内では「© < _イタリック_」は変換されません。"
```
}}
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
```shell
echo "１行目。コードブロック内では「© < _イタリック_」は変換されません。"
echo "２行目。コードブロック内では「© < _イタリック_」は変換されません。"
```
}}
[[*1|#p2]][[*2|#p2]]の環境では、コードブロック内に空行を入れるとコードブロック内とは解釈されず通常の文字と判断されます。
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
``` shell
echo "１行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
echo "２行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
```
}}
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
``` shell
echo "１行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
echo "２行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
```
}}
!! コードブロック(三重チルダ上下挟み) [[*1|#p2]][[*2|#p2]]
// Pandoc-style fenced code blocks
開始の三重チルダの前に空行が入っていないと、文書中（インライン）と解釈され二重チルダ挟み打消しになります。
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
~~~shell
echo "１行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
echo "２行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
~~~
}}
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
~~~shell
echo "１行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
echo "２行目。コードブロック内に空行を含む場合でも「© < _イタリック_」は変換されてはなりません。"
~~~
}}
!! タグによるコードブロック
preタグとcodeタグを使います。
ただし、タグ後の改行と後の改行は、それぞれ内の最初と最後の改行と解釈されます。
また、実体参照符号へは自動変換されないため、手動で変換しなければなりません。
{{markdown
echo "1行目。<code>タグ後に改行がある場合。"
echo "2行目。</code>タグ後に改行がある場合。"
}}
{{markdown
echo "1行目。<code>タグ後に改行がある場合。"
echo "2行目。</code>タグ後に改行がある場合。"
}}
以下のように記述すると囲み内の最初と最後の改行は行われなくなります。
{{markdown
echo "1行目。<code>タグ後に改行がある場合。"
echo "2行目。</code>タグ後に改行がある場合。"
}}
{{markdown
echo "1行目。<code>タグ後に改行がある場合。"
echo "2行目。</code>タグ後に改行がある場合。"
}}
!! コードブロック（4スペース以上のインデント）
空行に続く4スペース以上のインデントはコードブロックになります。
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
echo "コードブロック内（4スペース以上インデントされた行）では「© < _イタリック_」は変換されません。"
}}
{{markdown
コードブロック外では「© < _イタリック_」は変換されます。
echo "コードブロック内（4スペース以上インデントされた行）では「© < _イタリック_」は変換されません。"
}}
! インデント幅とコードブロック範囲の関係
スペース又はタブのみからなる行と空行を無視して、
4スペース以上のインデントの行が連続する範囲がコードブロックと見なされます。
{{markdown
echo "1スペースインデント。--------------- ここは本文 ---------------"
echo "2スペースインデント"
echo "3スペースインデント。--------------- ここまでは本文 ---------------"
echo "4スペースインデント。--------------- ここからコードブロック ---------------"
echo "5スペースインデント"
echo "6スペースインデント"
echo "1タブインデント"
echo "2タブインデント"
echo "4スペースインデント。前行は1タブスペース"
echo "4スペースインデント。前行は1スペース。------ ここまでコードブロック ------"
}}
{{markdown
echo "1スペースインデント。--------------- ここは本文 ---------------"
echo "2スペースインデント"
echo "3スペースインデント。--------------- ここまでは本文 ---------------"
echo "4スペースインデント。--------------- ここからコードブロック ---------------"
echo "5スペースインデント"
echo "6スペースインデント"
echo "1タブインデント"
echo "2タブインデント"
echo "4スペースインデント。前行は1タブスペース"
echo "4スペースインデント。前行は1スペース。------ ここまでコードブロック ------"
}}
!! コードブロックの入れ子 [[*1|#p2]][[*2|#p2]]
３個以降連続する`及び３個以降連続する~の内、コードブロック内で使用されていないもので上下を挟むか、インデントでのコードブロックを使用します。
{{markdown
````` text
入れ子１段目
```` text
入れ子２段目
~~~ fswiki
入れ子３段目
{{markdown
``` shell
echo "入れ子４段目"
```
}}
~~~
````
`````
}}
{{markdown
````` text
入れ子１段目
```` text
入れ子２段目
~~~ fswiki
入れ子３段目
{{markdown
``` shell
echo "入れ子４段目"
```
}}
~~~
````
`````
}}
!!! LaTeX埋込 拡張構文 [[*1|#p2]][[*2|#p2]][[*3|#p2]]
本構文を利用するには、まず Discount 2.2.3以降を使用している Discount.pm 中のランタイムフラグに MKD_LATEX() を追加します。
これにより、$$…$$、\[…\]、\(…\) のいずれかで挟まれている中身は
（前述の実体参照符号化を除いて）そのまま出力されるようになります。
ただし、以下の注意が必要です。
・間に空行を入れられません。
・Discount 2.2.7 (v2maint 34a8ebb)では、Markdownブロック中の「\」は「\\」にエスケープする必要があります。具体的には、
・\[…\]、\(…\) は \\[…\\] または \\(…\\)）とし、
・LaTeXで改行を意味する「\\」は「\\\\」に変更する必要があります。
さらに、LaTeX として出力するためには、 [MathJax|https://github.com/mathjax/MathJax/] などの設定を行う必要があります。
詳しくは 、[こちら|https://github.com/KazKobara/kati_dark/tree/main/docs/markdown/markdown_plugin_for_fswiki.md]の MathJax の設定に関する記述をご参照下さい。
! Markdownブロック内での記述
{{markdown
}}
{{markdown
}}
行内に LaTeX を表示させる場合
`\\(` と `\\)` で(空行を入れず)挟みます。
{{markdown
例えば、 \\( \sin^{2} \theta + \cos^{2} \theta = 1 \\) のように。
}}
{{markdown
例えば、 \\( \sin^{2} \theta + \cos^{2} \theta = 1 \\) のように。
}}
`\\[` と `\\]`、または、`$$` と `$$` で(空行を入れず)挟む場合、
{{markdown
以下のように
\\[ \tan \theta = \frac{\sin \theta}{\cos \theta} \\] および
$$ \lim_{h \to 0} \frac{f(x+h) - f(x)}{h} $$ の数式は、
１行で記述したとしても独立した行に表示されます。
}}
{{markdown
以下のように
\\[ \tan \theta = \frac{\sin \theta}{\cos \theta} \\] および
$$ \lim_{h \to 0} \frac{f(x+h) - f(x)}{h} $$ の数式は、
１行で記述したとしても独立した行に表示されます。
}}
`\begin` `\end` で挟まれていれば、`$$…$$, \\[…\\], \\(…\\) ` は不要です。
また、LaTeX で改行を意味する「\\」は「\\\\」に変更する必要があります。
{{markdown
\begin{eqnarray}
x & = & \sum_{i=1}^n i \\\\
& = & \frac{n (n+1)}{2} \\\\
& \leq & \alpha
\end{eqnarray}
}}
{{markdown
\begin{eqnarray}
x & = & \sum_{i=1}^n i \\\\
& = & \frac{n (n+1)}{2} \\\\
& \leq & \alpha
\end{eqnarray}
}}
MathMLの記述はそのまま Markdownブロック内に張り付けます。
{{markdown
}}
{{markdown
}}
MathJaxで表示された数式から、それに対応する MathML や LaTeX での記述を得る方法につきましては、
[こちら|https://github.com/KazKobara/kati_dark/tree/main/docs/markdown/markdown_plugin_for_fswiki.md]などをご参照下さい。
! Markdownブロック外での記述
上記の script タグが追加されたページは、Markdownブロック外においても（整形済テキストの範囲を除いて）\( \LaTeX \)(まはたMathML)が埋め込まれるようになります。
Markdownブロック内との違いは以下のとおりです。
行内に表示させる場合
- `\\(` と `\\)` の代わりに `\(` と `\)` を使います。ただし、行頭では使えません。
例えば、\( a_2 x^2 + a_1 x + a_0 = \frac{1}{2} \) のように使います。
例えば、\( a_2 x^2 + a_1 x + a_0 = \frac{1}{2} \) のように使います。
独立した行に表示させる場合
- `\\[` と `\\]` の代わりに `\[` と `\]` を使います。ただし、行頭では使えません。
- `$$` と `$$` は行頭でも使えます。
例えば、
$$ \frac{4}{3} \pi r^3 $$のように。
行頭以外では \[ \frac{\sqrt{(x^{2}+1)}}{c_4} \] などの記述も可能です。
例えば、
$$ \frac{4}{3} \pi r^3 $$のように。
行頭以外では \[ \frac{\sqrt{(x^{2}+1)}}{c_4} \] などの記述も可能です。
- `\begin`、`\end` の書式は `$$` と `$$` で挟み、行頭がスペースや `\` にならないようにします。
- LaTeX で改行を意味する「\\」を「\\\\」に変更する必要はありません。
$$ \begin{pmatrix}
a & b \\
c & d \end{pmatrix} $$
$$ \begin{pmatrix}
a & b \\
c & d \end{pmatrix} $$
なお、Markdownブロック外でのみ LaTeX を表示させるのであれば [tex2jax の後継|http://fswiki.osdn.jp/cgi-bin/wiki.cgi?page=BugTrack%2Dwiki%2F352] を検討するという方法もあります。
//!!! その他の Discount 拡張構文
//
{{markdown
}}
!!! 既知の不具合
! FSWikiのPDFプラグインでは、Markdownブロック内の記述は表示されません。
* [解決策] PDFへはWebブラウザなどを用いてご変換下さい。
* [設定例] 印刷で「PDFとして保存」、「レイアウト:縦」を選択し、「その他の設定」で「拡大/縮小(%)」を Chrome や Edge では 120 辺り、「余白: なし」に設定し、「 背景グラフィクス」にチェックを入れます。
//** なお、Firefox 97 で作成した PDF を Acrobat Reader DC 2021.011 64ビットで開くと、リンクのページ辺りで「文書を読み取り中に問題が発生しました(14)。」が表示されます（Firefox 98, Chrome, Edge では正常に表示されます）。