# --markdown-selector

Source: https://zshot-cli.com/reference/flags/document/markdown-selector/
Markdown: https://zshot-cli.com/reference/flags/document/markdown-selector/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Flags](https://zshot-cli.com/reference/flags/) › [Document](https://zshot-cli.com/reference/flags/document/)
CLI: `--markdown-selector` · REST: [`markdown_selector`](https://zshot-cli.com/reference/server/api/schema/#markdown_selector)
Value: `SELECTOR`
License: [Standard](https://zshot-cli.com/support/licenses/standard)

Converts only the elements matching this CSS selector, in page order. An invalid or selector that matches nothing will cause an error.

## Example

**CLI**

```sh
zshot -f page.md \
  --markdown-selector "article" \
  https://zshot-cli.com/example_assets/gazette/
```

**JSON** — `POST /` body for the [API](/reference/server/api), Pro license

```json
{
  "url": "https://zshot-cli.com/example_assets/gazette/",
  "output_type": "markdown",
  "markdown_selector": "article"
}
```

**curl**

```sh
curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/example_assets/gazette/","output_type":"markdown","markdown_selector":"article"}' \
  -o page.md
```

## Related

Flags:

- [`--markdown-no-title`](https://zshot-cli.com/reference/flags/document/markdown-no-title/)
- [`--markdown-format`](https://zshot-cli.com/reference/flags/document/markdown-format/)

Topics:

- [Markdown](https://zshot-cli.com/reference/formats/markdown/)
- [Exit Codes](https://zshot-cli.com/reference/exit_codes/)
- [CSS Selectors](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_selectors)

## Navigation

- [Examples](https://zshot-cli.com/examples/)
- [Download](https://zshot-cli.com/download/)
- [Purchase](https://zshot-cli.com/purchase/)
- [Reference](https://zshot-cli.com/reference/)
  - [Formats](https://zshot-cli.com/reference/formats/)
  - [Flags](https://zshot-cli.com/reference/flags/)
    - [Common](https://zshot-cli.com/reference/flags/common/)
    - [Agents](https://zshot-cli.com/reference/flags/agents/)
    - [Archive](https://zshot-cli.com/reference/flags/archive/)
    - [Browser](https://zshot-cli.com/reference/flags/browser/)
    - [Diagnostics](https://zshot-cli.com/reference/flags/diagnostics/)
    - [Document](https://zshot-cli.com/reference/flags/document/)
      - [--llm-format-expects](https://zshot-cli.com/reference/flags/document/llm-format-expects/)
      - [--llm-format-model](https://zshot-cli.com/reference/flags/document/llm-format-model/)
      - [--llm-format-prompt](https://zshot-cli.com/reference/flags/document/llm-format-prompt/)
      - [--llm-no-screenshot-labels](https://zshot-cli.com/reference/flags/document/llm-no-screenshot-labels/)
      - [--markdown-embed-content](https://zshot-cli.com/reference/flags/document/markdown-embed-content/)
      - [--markdown-format](https://zshot-cli.com/reference/flags/document/markdown-format/)
      - [--markdown-no-title](https://zshot-cli.com/reference/flags/document/markdown-no-title/)
      - **--markdown-selector**
      - [--pdf-generate-document-outline](https://zshot-cli.com/reference/flags/document/pdf-generate-document-outline/)
      - [--pdf-generate-tagged-pdf](https://zshot-cli.com/reference/flags/document/pdf-generate-tagged-pdf/)
      - [--pdf-height](https://zshot-cli.com/reference/flags/document/pdf-height/)
      - [--pdf-landscape](https://zshot-cli.com/reference/flags/document/pdf-landscape/)
      - [--pdf-prefer-css-page-size](https://zshot-cli.com/reference/flags/document/pdf-prefer-css-page-size/)
      - [--pdf-scale](https://zshot-cli.com/reference/flags/document/pdf-scale/)
      - [--pdf-width](https://zshot-cli.com/reference/flags/document/pdf-width/)
    - [Image](https://zshot-cli.com/reference/flags/image/)
    - [Navigator](https://zshot-cli.com/reference/flags/navigator/)
    - [Security](https://zshot-cli.com/reference/flags/security/)
    - [Server](https://zshot-cli.com/reference/flags/server/)
    - [Video](https://zshot-cli.com/reference/flags/video/)
  - [Agents](https://zshot-cli.com/reference/agents/)
  - [Configuration](https://zshot-cli.com/reference/configuration/)
  - [Crawling](https://zshot-cli.com/reference/crawling/)
  - [Docker](https://zshot-cli.com/reference/docker/)
  - [Exit Codes](https://zshot-cli.com/reference/exit_codes/)
  - [Linux](https://zshot-cli.com/reference/linux/)
  - [LLM Connections](https://zshot-cli.com/reference/llm_connections/)
  - [LLM Formatting](https://zshot-cli.com/reference/llm_formatting/)
  - [Local Inputs](https://zshot-cli.com/reference/inputs/)
  - [Navigator](https://zshot-cli.com/reference/navigator/)
  - [Security](https://zshot-cli.com/reference/security/)
  - [Server](https://zshot-cli.com/reference/server/)
  - [Shell completions](https://zshot-cli.com/reference/shell_completions/)
  - [Storage](https://zshot-cli.com/reference/storage/)
  - [Timeouts](https://zshot-cli.com/reference/timeouts/)
  - [Web Bot Auth](https://zshot-cli.com/reference/web_bot_auth/)
- [Support](https://zshot-cli.com/support/)
- [Changelog](https://zshot-cli.com/changelog/)

Site index: https://zshot-cli.com/llms.txt