Въпреки че базовите JSON масиви се конвертират лесно в Markdown таблици, реалните данни често съдържат многомерни масиви, вложени обекти, булеви стойности и null. Синтаксисът на Markdown таблиците е двуизмерен и се основава на прости редове и колони без поддръжка за вложени под-таблици.
Стратегии за представяне на вложен JSON в Markdown
При конвертиране на сложни JSON структури Utiliome предлага интелигентни стратегии за форматиране:
1. Компактна сериализация на вложени обекти
За JSON обекти, съдържащи вложени под-обекти (напр. { "user": { "name": "Alex", "city": "Seattle" } }), Utiliome запазва структурата, като показва вложения обект като компактен JSON низ директно в клетката:
| user |
| {"name":"Alex","city":"Seattle"} |
Този подход запазва данните непокътнати, без изкуствено разширяване на колоните.
2. Текстова сериализация за вложени масиви
Когато дадено свойство съдържа масив или списък (напр. { "roles": ["admin", "editor"] }), Utiliome го сериализира като компактен JSON низ в клетката:
| Username |
Roles |
| dev_user |
["admin","editor"] |
3. Правилна обработка на Null и булеви стойности
Празните стойности (null), липсващите ключове и булевите флагове се форматират предвидимо. Utiliome конвертира булевите стойности чрез String() в true или false, null се изписва като null, а липсващите свойства остават като празни клетки в таблицата.
Синтаксис на разделителите в Markdown
GitHub-Flavored Markdown (GFM) изисква разделителен ред между заглавията и данните. Utiliome генерира чисти стандартни разделители:
- Стандартен разделител (
|---|): Разделя колоните последователно без специфично подравняване, осигурявайки максимална съвместимост с всички Markdown четци.
Безпроблемна интеграция с платформи за разработчици
Генерираният от Utiliome резултат съответства стриктно на CommonMark и GFM спецификациите:
- GitHub & GitLab: Поставяйте директно в
README.md файлове, pull request резюмета и коментари.
- Notion & Coda: Копирайте форматирания Markdown текст и го поставете в Notion, където той автоматично се превръща в Notion таблица.
- Jira & Confluence: Поставяйте в технически спецификации и доклади за грешки.
- Генератори на статични сайтове: Използвайте в съдържание за Hugo, Docusaurus, MkDocs, Astro и Next.js сайтове.
| YAML 1.2.2 Construct |
YAML Input Example |
RFC 8259 JSON Output |
Conversion Rule |
| Block Mappings |
server:\n host: 127.0.0.1 |
{"server": {"host": "127.0.0.1"}} |
Converted to JSON object ({...}) |
| Block Sequences |
ports:\n - 80\n - 443 |
{"ports": [80, 443]} |
Converted to JSON array ([...]); order preserved |
| Multiline Block Scalars |
`desc: |
\n Line 1\n Line 2` |
{"desc": "Line 1\nLine 2\n"} |
| Anchors & Aliases |
base: &b\n retry: 3\napi: *b |
{"base": {"retry": 3}, "api": {"retry": 3}} |
Aliases resolved into explicit JSON objects |
| Hash Comments |
# Comment\nkey: val |
{"key": "val"} |
Stripped (JSON specification forbids comments) |