Method runMarkdown

internal/cmd/docs_edit.go:1057–1124

runMarkdown converts the supplied content from markdown to Google Docs formatting and inserts it at insertIndex. It reuses the same converter + insertion helper that backs `docs write --markdown` and the non-replacing branch of `docs update --markdown`, so headings, fenced code blocks, lists, tables

(
	ctx context.Context,
	svc *docs.Service,
	docID string,
	insertIndex int64,
	requiredRevisionID string,
	content string,
)

// branch of `docs update --markdown`, so headings, fenced code blocks, lists,
// tables and images render identically regardless of which command placed them.
func (c *DocsInsertCmd) runMarkdown(
	ctx context.Context,
	svc *docs.Service,
	docID string,
	insertIndex int64,
	requiredRevisionID string,
	content string,
) error {
	markdown := prepareMarkdown(content)
	insertResult, err := insertPreparedDocsMarkdownAtWithWriteControl(
		ctx,
		svc,
		docID,
		insertIndex,
		markdown,
		c.Tab,
		true,
		docsRequiredRevisionWriteControl(requiredRevisionID),
	)
	if err != nil {
		if isDocsNotFound(err) {
			return fmt.Errorf("doc not found or not a Google Doc (id=%s)", docID)
		}
		return err
	}
	requestCount := insertResult.RequestCount
	if markdownMayContainHeadingLinks(markdown.cleaned) {
		explicitHeadingAnchors := docsmarkdown.ExplicitHeadingAnchors(markdown.cleaned)
		rewritten, rewriteErr := rewriteMarkdownHeadingLinksInRange(
			ctx,
			svc,
			docID,
			c.Tab,
			explicitHeadingAnchors,
			insertResult.ContentStart,
			insertResult.ContentEnd,
		)
		if rewriteErr != nil {
			return fmt.Errorf("rewrite heading links: %w", rewriteErr)
		}
		requestCount += rewritten
	}

	if outfmt.IsJSON(ctx) {
		payload := map[string]any{
			"documentId": docID,
			"inserted":   insertResult.Inserted,
			"requests":   requestCount,
			"atIndex":    insertIndex,
			"markdown":   true,
		}
		if c.Tab != "" {
			payload["tabId"] = c.Tab
		}
		return outfmt.WriteJSON(ctx, stdoutWriter(ctx), payload)
	}

	u := ui.FromContext(ctx)