markdownToFragment

Summary

Convert a Markdown string into an SDM/1 structural fragment.

Operation ID: markdownToFragment
API member path: editor.doc.markdownToFragment(...)
Mutates document: no
Idempotency: idempotent
Supports tracked mode: no
Supports dry run: no
Deterministic target resolution: yes

Expected result

Returns an SDMarkdownToFragmentResult with the converted fragment, lossy flag, and diagnostics.

Input fields

Field	Type	Required	Description
`markdown`	string	yes

Example request

{
  "markdown": "example"
}

Output fields

Field	Type	Required
`diagnostics`	object[]	yes
`fragment`	any	yes
`lossy`	boolean	yes

Example response

{
  "diagnostics": [
    {
      "code": "INVALID_TARGET",
      "message": "Operation failed.",
      "path": [
        "example"
      ],
      "severity": "error"
    }
  ],
  "fragment": {},
  "lossy": true
}

Pre-apply throws

None

Non-applied failure codes

None

Raw schemas

Raw input schema

{
  "additionalProperties": false,
  "properties": {
    "markdown": {
      "type": "string"
    }
  },
  "required": [
    "markdown"
  ],
  "type": "object"
}

Raw output schema

{
  "additionalProperties": false,
  "properties": {
    "diagnostics": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "path": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "severity": {
            "enum": [
              "error",
              "warning",
              "info"
            ],
            "type": "string"
          }
        },
        "required": [
          "code",
          "severity",
          "message"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "fragment": {},
    "lossy": {
      "type": "boolean"
    }
  },
  "required": [
    "fragment",
    "lossy",
    "diagnostics"
  ],
  "type": "object"
}

⌘I

Getting Started

Editor

Document Engine

AI

Solutions

Resources

markdownToFragment

Summary

Expected result

Input fields

Example request

Output fields

Example response

Pre-apply throws

Non-applied failure codes

Raw schemas

​Summary

​Expected result

​Input fields

​Example request

​Output fields

​Example response

​Pre-apply throws

​Non-applied failure codes

​Raw schemas

Summary

Expected result

Input fields

Example request

Output fields

Example response

Pre-apply throws

Non-applied failure codes

Raw schemas