web-dev-qa-db-ja.com

Bitbucket WikiのMarkdownのテーブルセル内に改行を追加するにはどうすればよいですか?

Bitbucket WikiのMarkdownのテーブルセル内に改行を追加するにはどうすればよいですか?

<br>-動作しません

<br/>-動作しません

箇条書き-機能しません

6
Dims

<br>または<br />が機能しない場合は、おそらく機能しません。

残念ながら、 table サポートに関するBitbucketのドキュメントはかなりまばらで、次の例のみで構成されています。

| Day     | Meal    | Price |
| --------|---------|-------|
| Monday  | pasta   | $6    |
| Tuesday | chicken | $8    |

ただし、その構文は、最初に PHP Markdown Extra によって導入され、後に GitHubMultiMarkdown などによって普及したかなり一般的なテーブル構文のように見えます。

PHP MarkdownExtraのルールは次のように述べています。

通常のMarkdown構文を使用して、各セルのコンテンツにスパンレベルの書式を適用できます。

| Function name | Description                    |
| ------------- | ------------------------------ |
| `help()`      | Display the help window.       |
| `destroy()`   | **Destroy your computer!**     |

GitHubの仕様には次のように明記されています。

ブロックレベルの要素をテーブルに挿入することはできません。

そしてMultiMarkdownのルールは次のように述べています。

セルの内容は1行のみにする必要があります

実際、構文では、ある行がいつ終了し、別の行がいつ開始するかを定義する方法が提供されていないことに注意してください(テーブルの本体から分割する行を含むヘッダー行とは異なります)。行間の分割を定義することはできないため、それが機能する唯一の方法は、各行が独自の行である場合です。そのため、1行に複数行のテキストを含めることはできません。

したがって、テーブルセル内のテキストはインラインテキストのみである必要があり、1行で表すことができます(したがって、2つのスペースの後に改行が続くMarkdown標準は機能しません。また、ブロックレベルのリスト要素であるため、箇条書きも機能しません。 )。もちろん、生のHTML <br>タグはインラインテキストであり、テーブルセル内に改行を挿入する方法として適格です。ただし、一部のMarkdown実装では、セキュリティ対策としてすべての生のHTMLを許可していません。このような実装(Bitbucketが使用しているように見える)を使用している場合、テーブルセルに改行を含めることはできません。

私は、上記のイライラと制限を感じる人がいることに気づきました。ただし、テーブルに関するMultiMarkdownのドキュメントで次のアドバイスに注意するのは興味深いことです。

MultiMarkdownテーブルのサポートは、most人のmostテーブルを処理するように設計されています。 all人のallテーブルは対象外です。複雑なテーブルが必要な場合は、手動で、または出力形式用に特別に設計されたツールを使用してテーブルを作成する必要があります。ただし、ある時点で、MultiMarkdownテーブルの制限が大きすぎる場合は、テーブルが本当に最善のアプローチであるかどうかを検討する必要があります。

興味深い提案は、かなり制限されたテーブル構文でやりたいことができない場合は、テーブル以外のものを使用することを検討することです。ただし、テーブルが本当に適切なツールである場合は、手動で作成する必要がある場合があります。念のため、 元のルール 状態:

マークダウンはHTMLの代わりではなく、HTMLに近いものでもありません。その構文は非常に小さく、HTMLタグの非常に小さなサブセットにのみ対応します。 HTMLタグの挿入を容易にする構文を作成するという考え方はnotです。私の意見では、HTMLタグはすでに簡単に挿入できます。 Markdownのアイデアは、散文の読み取り、書き込み、編集を簡単にすることです。 HTMLはpublishing形式です。マークダウンは書き込み形式です。したがって、Markdownのフォーマット構文は、プレーンテキストで伝達できる問題にのみ対処します。

Markdownの構文でカバーされていないマークアップについては、HTML自体を使用するだけです。 MarkdownからHTMLに切り替えていることを示すために、序文や区切り文字を付ける必要はありません。タグを使用するだけです。

したがって、手動でテーブルを作成するには、テーブル全体に生のHTMLを使用する必要があります。もちろん、すべての生のHTMLを許可しない実装の場合、そのオプションはありません。したがって、テーブル以外のソリューション、またはセル内で改行せずにテーブルをフォーマットする方法のいずれかを検討することに戻ります。

3
Waylan

これは私にとってもうまくいきます1st line. <br>2nd line.<br/> 3rd line.

0
Jha