Въпреки че базовите 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 Construct |
Input Example |
Formatted Output Behavior |
YAML 1.2.2 / JS Value Rule |
| Nested Mappings |
b: 1\na:\n d: 2\n c: 3 |
Normalized to 2 or 4 spaces; keys sorted if toggled |
Mapping keys sorted recursively; values kept |
| Block Sequences |
items:\n - z\n - a |
Normalized indentation; item order [z, a] preserved |
Sequence order is never altered by key sorting |
| Hash Comments |
# Production port\nport: 443 |
port: 443 (comment stripped) |
Value-tree parsing drops # comments |
| Anchors & Aliases |
defaults: &d\n timeout: 5\napi: *d |
Resolves alias into explicit key-value pairs |
yaml.parse resolves aliases into JS objects |
| Norway Problem Strings |
country: NO |
Preserved as string NO in YAML 1.2 |
YAML 1.2 only treats true/false as booleans |