CSVをMDに変換する方法
- CSVテキストを貼り付けるか、対応する
.csvファイルをアップロードします。 - 区切り文字、引用符文字、ヘッダー行、文字エンコーディングを確認します。
- 解析された行と生成されたMarkdownテーブルをプレビューします。
- テーブルをコピーするか、
.mdファイルをダウンロードします。
変換ツールが保持するものは？
| ソースコンテンツ | 推奨される出力動作 | 変換に関する注意 |
|---|---|---|
| ヘッダー行 | 最初の行または設定された行を見出しとして使用 | |
| 行と列 | 解析された長方形のデータを保持 | |
| 引用符で囲まれた区切り文字 | 引用符で囲まれたフィールド内のカンマまたは区切り文字を保持 | |
| エスケープされた引用符 | 二重引用符文字を正しくデコード | |
| 空のフィールド | 空のセルをレンダリング | |
| フィールド内の改行 | エスケープ、置換、またはHTML改行を使用 | |
| パイプ文字 | GFMセルが有効なままになるようにエスケープ | |
| 配置 | オプションの列配置を生成 |
変換中に変更される可能性があるもの
複数行およびリッチなセルコンテンツ
Markdownテーブルのセルは、改行、リスト、ブロックコンテンツのサポートが限られています。
非常に大きなデータセット
数千行は技術的に有効ですが、読みにくいMarkdownテーブルを生成する可能性があります。公開する前に出力を確認してください。
文字エンコーディング
Windows-1252、Shift_JIS、または他の文字セットでエンコードされたファイルは、UTF-8としてデコードすると正しく表示されない場合があります。
不規則な行
フィールド数が異なる行には、エラー、修正ルール、または明示的なパディングポリシーが必要です。
データ型
CSVは本質的に数値、日付、ブール型を保持しません。Markdownはテキストを表示します。
CSVからMarkdownへの一般的な用途
READMEにデータを追加
コンパクトな互換性マトリックスや機能リストをバージョン管理されたテーブルに変換します。
クエリ結果を共有
小さなエクスポートをIssue、プルリクエスト、サポートチケットに貼り付けます。
APIフィールドを文書化
CSVに保存されたスキーマやフィールドリストを読みやすい参照テーブルに変換します。
表形式のメモをObsidianに移動
さらなる計算のためにCSVを保持しながら、ポータブルなテキストテーブルを作成します。
CSVからMarkdownへの例
name,description,status
Alpha,"Fast, simple",active
Beta,"A | B",paused| name | description | status |
|---|---|---|
| Alpha | Fast, simple | active |
| Beta | A \| B | paused |よりきれいなMarkdown出力のためのヒント
- 区切り文字を確認 カンマ、セミコロン、タブ区切りのファイルは、プレーンテキストのプレビューでは似て見えることがあります。
- 本格的なCSVパーサーを使用 単純な文字列分割では、引用符で囲まれたカンマ、エスケープされた引用符、複数行フィールドが壊れます。
- ドキュメント用に行数を制限 簡潔なテーブルは、データセット全体を貼り付けるよりも有用です。
- 変換前にエンコーディングを確認 Markdown生成後ではなく、デコード段階で文字化けを修正します。
- パイプと改行をプレビュー これらの文字は、一貫してエスケープされないとテーブル構造を壊す可能性があります。
よくある質問
CSVの最初の行はテーブルのヘッダーになりますか？
最初のデータ行がMarkdownテーブルのヘッダーになります。 CSVがデータで始まる場合は、変換前にヘッダー行を準備してください。
パイプ文字は自動的にエスケープされますか？
はい。 パイプ文字はエスケープされ、正しいGFMテーブルセル内に残ります。
引用符で囲まれたフィールド内のカンマはどのように処理されますか？
引用符で囲まれたカンマは同じセル内に残ります。 CSVパーサーはエスケープされた引用符文字も処理します。
複数行のCSVセルはどうなりますか？
セル内の改行は<br>になります。 これにより、GitHub Flavored Markdownで行が長方形に保たれます。
セミコロンやタブを区切り文字として使用できますか？
はい。 区切り文字の検出は、カンマ、セミコロン、タブ、パイプをサポートしています。
空のセルは保持されますか？
はい。 空のセルは空のままで、後の列の値がずれることはありません。
数値列を右揃えにできますか？
GFMの配置マーカーは、左、中央、右の配置を表現できます。
CSVファイルのサイズはどのくらいまで可能ですか？
変換ツールは固定のファイルサイズ制限を課しません。 非常に大きなCSVファイルは処理に時間がかかる場合があり、そのMarkdownテーブルは読みにくくなる可能性があるため、公開前に大きな出力を確認してください。
MarkdownをPDFに戻す
すでにMarkdownファイルをお持ちですか？MarkdownからPDFへの変換ツールを使用して、共有可能なPDFを作成します。