Въпреки че базовите 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 сайтове.
| TOML v1.0.0 Construct |
Input Example |
Formatter / Serializer Behavior |
Validation Rule |
| Standard Tables |
[package]\nname="app" |
Formats as [package]\nname = "app" |
Rejects duplicate table redefinitions |
| Dotted Keys |
server.host = "0.0.0.0" |
Expanded into normalized table hierarchy |
Rejects conflicting scalar/table key paths |
| Arrays of Tables |
[[bin]]\nname = "cli" |
Preserves [[bin]] array-of-tables blocks |
Validates array element consistency |
| RFC 3339 Datetimes |
created = 2026-05-01T10:00:00Z |
Validated and serialized as TOML datetime |
Flags invalid calendar dates or offsets |
| Hash Comments |
# Build settings |
Stripped during value-tree parsing |
Ignored by parser; omitted in output |