Markdown テーブル: パイプを数える代わりにテーブルを生成し

構文の一例では、

                | Tool          | Input       | Offline |
| :------------ | :---------: | ------: |
| YAML to JSON  | YAML        | yes     |
| JWT decoder   | JWT         | yes     |
              

最初の行はヘッダー、2 番目の行は区切り文字行、その後はすべてデータです。区切り文字行のコロンは、配置を設定します: `:---` 左、`:---:` 中央、`---:` 右。 GitHub とほとんどのレンダラーは先頭と末尾のパイプをオプションとして受け入れますが、これらを含めることで生のテキストをエディターで読み取れる状態に保ちます。

テーブルを壊す 3 つの要素

• セル内のパイプ — `\|` としてエスケープするか、行が 1 つの列に分割されすぎています。
• 区切り行の列数が間違っている - ヘッダーが移動し、テーブルがずれて表示されます。
• テーブル内の空白行 — レンダラーはこれをテーブルの終わりとして扱い、残りをテキストとして出力します。

エスケープは、セル内のコードと正規表現にとって最も重要です。 `a|b` と `\bfoo\b` は両方とも、テーブル内で問題なく動作する前に注意が必要です。

スプレッドシートからデータを取得する

自然なワークフローは、スプレッドシートまたは CSV エクスポートから選択内容を貼り付け、ジェネレータに引用と位置合わせを行わせることです。これは、行を入力するよりも高速でエラーが発生しにくく、可変の列幅、右揃えにする必要がある数値、カンマを含むセルなどの退屈なケースにも対応します。空白としてレンダリングされる架空の列が表に含まれるのを避けるために、貼り付ける前に末尾の空の列をトリミングします。

テーブルを使用しない場合

表は比較用です: 機能マトリックス、フラグ参照、互換性リスト、環境変数。散文には適しておらず、長い説明には適しておらず、マークダウンには応答動作がないため、狭い画面では苦痛です。レンダラーは水平にスクロールするか、列を読み取れない細片に押し込むかのどちらかです。セルに段落が必要な場合は、代わりに定義リスト、エントリごとの見出し、または箇条書きリストを使用します。携帯電話で誰も読めない表は、置き換えられたリストよりも悪いです。

生成して任意の場所に貼り付けます

出力はプレーンなマークダウンであるため、README、プル リクエストの説明、Wiki ページ、Jira チケット、またはコメントに直接組み込まれます。 YamlBox マークダウン テーブル ジェネレーターはブラウザーで実行され、列を整列し、パイプをエスケープし、オフラインで動作し続けるため、どこにも公開せずに内部データを貼り付けることができます。