From 4e564a98593ee155ec596a5a00211ab7f925e61f Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Fri, 9 Oct 2026 03:52:24 +0200 Subject: [PATCH] Answer product-owner round 2: keeping an image an image needs nothing else on its line, and a quoted image is pinned --- MIGRATION.md | 2 +- README.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/MIGRATION.md b/MIGRATION.md index 7f38a88..a1fa028 100644 --- a/MIGRATION.md +++ b/MIGRATION.md @@ -79,7 +79,7 @@ four now reads, or refuses with the code the table gives. | Input | `0.1.0` | `0.2.0` | | --- | --- | --- | -| an image anywhere but alone in a plain paragraph (`See ![a](u).`, `# ![a](u)`), on parse | `unmappable-image` | its alt text linked to its URL, or, inside a link, plain text the link marks; give the image a paragraph of its own, a blank line before and after, to keep it an image | +| an image anywhere but alone in a plain paragraph (`See ![a](u).`, `# ![a](u)`), on parse | `unmappable-image` | its alt text linked to its URL, or, inside a link, plain text the link marks; give the image a paragraph of its own, with a blank line between it and any text, to keep it an image | | a titled image alone in its paragraph (`![a](u "t")`), on parse | `unmappable-image` | the image, captioned with its title | | an image that is a link's whole text, alone in its paragraph (`[![a](u)](/v)`), on parse | `unmappable-image` | the image, its `media` marked with the link | | a link whose `href` or `title` no CommonMark escape spells, on emit | `unspellable-link` | spells `!adf:link[text]{attrs}` | diff --git a/README.md b/README.md index 635b7c8..abed14c 100644 --- a/README.md +++ b/README.md @@ -247,8 +247,8 @@ Serves Goals 1, 4 and 5. `See ![the moon](moon.png).` as `See [the moon](moon.png).`, and inside a link as plain text the link marks — unless the link's whole text is the image and the link stands alone in a plain paragraph, which reads as the image the link marks. To keep an image an image, give it - a paragraph of its own, a blank line before and after, in a list item or a quote too: images - on consecutive lines share a paragraph. + a paragraph of its own: nothing else on its line, and a blank line between it and any text + above or below. Images on consecutive lines share a paragraph. - An image's title becomes its caption when the image stays an image, and its link's title when it becomes linked alt text. Inside another link, the title is dropped.