diff --git a/format/v2/INLINE_MARKUP.md b/format/v2/INLINE_MARKUP.md index 05a0c5e..d153a98 100644 --- a/format/v2/INLINE_MARKUP.md +++ b/format/v2/INLINE_MARKUP.md @@ -90,7 +90,7 @@ Where canonical output rewrites the string, the row says so. | `~x~` | literal | only runs of exactly two tildes delimit | | `^x^` | literal | | | `<u>` | the text `` | entities are decoded on input; canonical output writes `\` instead | -| `[t](anytype://object?objectId=X&spaceId=Y)` | an **ordinary link**, param verbatim | a second parameter makes it not-an-object-link. Guessing which half is the id and guessing wrong is unrecoverable, so nothing guesses | +| `[t](anytype://object?objectId=X&spaceId=Y)` | a **cross-space object link** — an ordinary link, param verbatim | the platform's own two-parameter deep link to an object in another space (`core/block/export/writer.go`); a second parameter makes it not-an-object-link here, and guessing which half is the id and guessing wrong is unrecoverable, so nothing guesses. The API expands a short space id in it to the full one on write | The delimiter set — `**`, `*`, `~~`, `` ` ``, `[…](…)` — is **closed**. A future version adds a mark as a tag, never as new punctuation, which is what makes diff --git a/format/v2/schema/object.schema.json b/format/v2/schema/object.schema.json index 69fbf30..f5ba219 100644 --- a/format/v2/schema/object.schema.json +++ b/format/v2/schema/object.schema.json @@ -941,7 +941,7 @@ }, "text": { "type": "string", - "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." + "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `[text](anytype://object?objectId=&spaceId=)` links to an object in another space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." } } } @@ -970,7 +970,7 @@ }, "text": { "type": "string", - "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." + "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `[text](anytype://object?objectId=&spaceId=)` links to an object in another space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." } } } @@ -996,7 +996,7 @@ }, "text": { "type": "string", - "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." + "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `[text](anytype://object?objectId=&spaceId=)` links to an object in another space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." } } } @@ -1019,7 +1019,7 @@ }, "text": { "type": "string", - "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." + "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `[text](anytype://object?objectId=&spaceId=)` links to an object in another space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." } } } @@ -1045,7 +1045,7 @@ }, "text": { "type": "string", - "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." + "description": "The block's text, with formatting written inline. There is no marks array and no offsets. The accepted syntax, and nothing else:\n `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``\n `[text](https://example.com)` links out\n `[text](anytype://object?objectId=)` links to an object in this space\n `[text](anytype://object?objectId=&spaceId=)` links to an object in another space\n `\">text` is a decorated object reference\n `underline`, `text`, `text`\nEverything else is literal text: no block syntax, no images, no autolinks, no other HTML. `\\n` is a soft line break. Escape a literal `*`, `` ` ``, `[`, `]`, `~`, `<` or `\\` with a backslash." } } }