---
title: stack kb markdowns put-markdowns-id cli command
description: Upsert a markdown library item Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4089/reference/elastic-cli/cli/stack/kb/markdowns/put-markdowns-id
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack kb markdowns put-markdowns-id cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack kb markdowns put-markdowns-id \
  --id <id> \
  --content <content> \
  --title <title> \
  [options]
```

Upsert a markdown library item
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--id string required">
    The unique ID of the markdown library item to be created or updated.
  </definition>
  <definition term="--content string required">
    The Markdown text rendered by the panel. Supports GitHub-flavored Markdown, including headings, paragraphs, lists, links, images, tables, blockquotes, and code blocks. Use `\n` for line breaks within JSON strings.
  </definition>
  <definition term="--title string required">
    The markdown library item title.
  </definition>
  <definition term="--description string">
    A short description of the markdown library item.
  </definition>
  <definition term="--settings string">
    Display settings for the markdown panel.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>