Въпреки че базовите 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 сайтове.
| UI Control / XML Construct |
Default Behavior (Toggle Off) |
Enabled Behavior (Toggle On) |
Underlying fast-xml-parser Rule |
| Ignore Attributes |
Keeps attributes as "@_attr": "val" |
Drops all XML attributes from output |
ignoreAttributes: false vs. true |
| Remove Namespace Prefixes |
Keeps "soap:Envelope" key names |
Strips prefix to "Envelope" |
removeNSPrefix: false vs. true |
| Parse Numbers and Types |
Tag values stay strings ("02134") |
Coerces tag numbers/booleans (2134, true) |
parseTagValue: false vs. true (attributes stay strings) |
| Force Arrays (Tag Names) |
Single child tag becomes object/scalar |
Listed tag names always wrap in [...] |
Custom isArray tag-name matcher |