From e949f2099c92e3d43cf9c2aa3a3f8e636bbf4d8a Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Wed, 30 Sep 2026 22:30:09 +0200 Subject: [PATCH] review: the notes bullet states when each note fires, syncBlock named --- README.md | 11 ++++++----- docs/decisions.md | 4 ++-- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index efadb57..e43453f 100644 --- a/README.md +++ b/README.md @@ -137,16 +137,17 @@ read replaces mentions, attachments and macros with text. | `table` | a pipe table: the first row its header, a cell's blocks on one line, a span kept under its header by empty cells | — | | `decisionList` | a bullet list | — | | `mention`, `status`, `emoji`, `date` | their text: `@` kept, a mention with none `@` and its id, an emoji its `shortName` without, a date `2026-09-13` in UTC | — | -| `inlineCard`, `blockCard`, `embedCard` | a link to the card's URL | — | +| `inlineCard`, `blockCard`, `embedCard` | a link to the card's URL, else its name | — | | external `media` | `![alt](url)` in a block, `[alt](url)` inline | — | | stored `media`, `mediaInline`, `extension`, `inlineExtension` | their `alt` or `text` | — | | `layoutSection`, `bodiedExtension`, `bodiedSyncBlock`, `multiBodiedExtension`, `extensionFrame`, `caption`, a node this version does not know | its blocks or its text | — | | `placeholder` | nothing | — | -- Content the document only references leaves an italic note naming it where it stood: - `_(image not included)_`, `_(synced block not included)_`, `_(link card not included)_` for a card - with no URL, and an extension's key, `_(jira-issues-table not included)_`, or - `_(extension not included)_` where it has none. +- Content the document only references, with no text of its own to keep, leaves an italic note + naming it where it stood: `_(image not included)_` for stored media with no `alt`, + `_(link card not included)_` for a card with neither URL nor name, an extension with no `text` + its key, `_(jira-issues-table not included)_`, or `_(extension not included)_` without one, and + `_(synced block not included)_` for a `syncBlock`. - `backgroundColor`, `code`, `em`, `link`, `strike` and `strong` stay; every other mark drops, keeping its text, and so does a mark the flavour cannot spell where it stands. - A newline in text is a hard break and in an expand's title a space, edge whitespace outside a diff --git a/docs/decisions.md b/docs/decisions.md index b6a3f9a..a1d0d34 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -156,8 +156,8 @@ MkDocs, Docusaurus, Typora, Joplin, Logseq, Bear, Notion, Azure DevOps and Disco renderer confirming each shape. Reader panels settled `error` as an error panel, the `==` bounds (3 of 3) and a Han, Hangul, kana, Thai, Lao, Khmer or Myanmar character on either side bounding a delimiter, so `は==日本語==で` (3 of 3), `==한국어==에서만` and `iPhone==専用==` (6 of 7) highlight, -the external image's two forms (6 of 7), the omission notes and a rule opening a list item -dropping (3 of 3), and a list's numbering overflowing into bullets (3 of 3, 5 of 7). +the external image's two forms (6 of 7), a rule opening a list item dropping and the omission +notes (3 of 3), and a list's numbering overflowing into bullets (3 of 3, 5 of 7). An omission note reads as the converter's, never as the author's. Reading takes other tools' spellings, since it reads their output and writes none of them. Rejected: `~sub~` and `^sup^` (`~2~` is a strike on GitHub, so `subsup` drops), underline and colour