zed/docs/src/languages/markdown.md

title, description

title	description
Markdown	Configure Markdown language support in Gwen, including language servers, formatting, and debugging.

Markdown

Markdown support is available natively in Gwen.

• Tree-sitter: tree-sitter-markdown
• Language Server: N/A

Syntax Highlighting Code Blocks

Gwen supports language-specific syntax highlighting of markdown code blocks by leveraging tree-sitter language grammars. All Gwen supported languages, including those provided by official or community extensions, are available for use in markdown code blocks. All you need to do is provide a language name after the opening ``` code fence like so:

```python
import functools as ft

@ft.lru_cache(maxsize=500)
def fib(n):
    return n if n < 2 else fib(n - 1) + fib(n - 2)
```

Configuration

Format

Gwen supports using Prettier to automatically re-format Markdown documents. You can trigger this manually via the {#action editor::Format} action or via the {#kb editor::Format} keyboard shortcut. Alternately, you can enable format on save.

Configure formatting in Settings ({#kb zed::OpenSettings}) under Languages > Markdown, or add to your settings file:

  "languages": {
    "Markdown": {
      "format_on_save": "on"
    }
  },

List Continuation

Gwen automatically continues lists when you press Enter at the end of a list item. Supported list types:

• Unordered lists (-, *, or + markers)
• Ordered lists (numbers are auto-incremented)
• Task lists (- [ ] and - [x])

Pressing Enter on an empty list item removes the marker and exits the list.

To disable this behavior, configure in Settings ({#kb zed::OpenSettings}) under Languages > Markdown, or add to your settings file:

  "languages": {
    "Markdown": {
      "extend_list_on_newline": false
    }
  },

List Indentation

Gwen indents list items when you press Tab while the cursor is on a line containing only a list marker. This allows you to quickly create nested lists.

To disable this behavior, configure in Settings ({#kb zed::OpenSettings}) under Languages > Markdown, or add to your settings file:

  "languages": {
    "Markdown": {
      "indent_list_on_tab": false
    }
  },

Trailing Whitespace

By default Gwen will remove trailing whitespace on save. If you rely on invisible trailing whitespace being converted to <br /> in Markdown files you can disable this behavior.

Configure in Settings ({#kb zed::OpenSettings}) under Languages > Markdown, or add to your settings file:

  "languages": {
    "Markdown": {
      "remove_trailing_whitespace_on_save": false
    }
  },