基本的なフラットJSON配列はMarkdownグリッドにきれいに変換されますが、実際のソフトウェアエンジニアリングデータには多次元配列、ネストされたオブジェクトツリー、ブール値、およびnull値が含まれていることがよくあります。Markdown表構文は本質的に2次元であり、ネストされたサブテーブルをネイティブにサポートせずにシンプルな行と列に依存しています。
MarkdownでネストされたJSONを表現するための戦略
複雑なJSON構造を変換する場合、Utiliomeは複雑な階層を読める表セルに変換するためのインテリジェントなフォーマット戦略を提供します:
1. ネストされたオブジェクトのインライン表示
ネストされたサブオブジェクトを含むJSONオブジェクトの場合、Utiliomeはドット記法による列の平坦化を行わず、コンパクトなインラインJSON文字列としてセル内に直接シリアル化します:
| user |
| {"name":"Alex","location":{"city":"Seattle"}} |
このアプローチにより、複雑なオブジェクト構造を損なうことなくセル内に保持されます。
2. サブ配列のインラインシリアル化
オブジェクトプロパティに埋め込み配列またはリストが含まれている場合(例: { "roles": ["admin", "editor", "billing"] })、Utiliomeは配列をコンパクトなインラインJSON文字列としてシリアル化します:
| Username |
Assigned Roles |
| dev_user |
["admin","editor","billing"] |
3. 適切なNullおよびブール値の処理
Null値、未定義のキー、およびブールフラグは、表内で明確にフォーマットされます。Utiliomeはブール値を String() により true/false 文字列に変換し、null 値は文字列の "null" として出力します。また、オブジェクト間で欠落しているプロパティは空セルとして処理され、表のグリッド構造を維持します。
GFM表の区切り線構文
GitHub-Flavored Markdown (GFM) 表では、ヘッダー行の下に区切り線が必要です。Utiliomeは標準の区切り線(|---|)を自動生成し、あらゆるMarkdownパーサーで確実に描画されるシンプルな表を出力します。
人気の開発者ワークスペースとのシームレスな統合
Utiliomeによって生成された出力は、CommonMarkおよびGFM仕様に厳密に準拠しており、すべての最新の開発者プラットフォームおよびコンテンツ管理ツール全体で完璧な描画を保証します:
- GitHub & GitLab:
README.md ファイル、プルリクエストの概要、リリースノート、および問題のコメントに直接貼り付けます。
- Notion & Coda: フォーマットされたMarkdownテキストをコピーしてNotionブロックに直接貼り付けると、ネイティブのNotionデータベース表に自動的に変換されます。
- Jira & Confluence: 仕様書やバグ報告の記述に貼り付けると、即座に読みやすい表として描画されます。
- 静的サイトジェネレーター: Hugo、Docusaurus、MkDocs、Astro、およびNext.jsサイトのMarkdownコンテンツファイルにコピーしても、Markdown解析例外を引き起こすことはありません。
| JSON Value Type |
Input Example |
CSV Cell Output |
RFC 4180 Escaping Behavior |
| String (Simple) |
"Alice" |
Alice |
Written unquoted unless delimiter, quote, or newline is present |
| String (With Comma/Quote) |
"Smith, Jr.", "6\" tall" |
"Smith, Jr.", "6"""" tall" |
Wrapped in quotes; internal double quotes doubled to "" |
| Number / Boolean |
42, true, false |
42, true, false |
Emitted as plain literal text tokens |
| Null / Undefined Key |
null or omitted property |
(empty cell) |
Emits nothing between adjacent field delimiters |
| Nested Array / Object |
["admin", "editor"] |
"[""admin"",""editor""]" |
Serialized via JSON.stringify and wrapped in CSV quotes |