Support for code block wrapped with "~~~"

[Masynchin]

Type: Feature Request

In my python function's docstring I wrote a code block, wrapped with ~~~. Turns out, it doesn't recognized as code block, as opposed to ``` variant. I want to use both for code blocks.

Extension version: 2023.7.20
VS Code version: Code 1.80.0 (Universal) (660393deaaa6d1996740ff4880f1bad43768c814, 2023-07-04T13:39:33.766Z)
OS version: Darwin arm64 22.2.0
Modes:

[rchiodo]

Thanks for the issue but I'm not sure I understand what you're asking for. Can you describe a more concrete example?

Is it something like this?

def foo():
    '''
    Doc string goes here
    ~~~
    Code block goes here?
    ~~~
    '''

If that's what you're looking for, I believe we turn all doc strings into markdown. Markdown usually follows this format:

def foo():
   """
   Comment here:
   ```python
   def bar():
      pass
   ```
   """

[rchiodo]

Is there another tool that supports ~~~ for code blocks?

[rchiodo]

Oh maybe github does :)

def foo():
   pass

[rchiodo]

Typescript in VS code does too.

[rchiodo]

Okay seems like we should just support this as it seems to be a standard for other tools and languages.

[Masynchin]

Yes, this is what I meant. I should have added this example:

def example():
    """
    Wrapped with backticks:

    ```python
    def function(a, b): ...
    ```

    Wrapped with tildas:

    ~~~python
    def function(a, b): ...
    ~~~
    """

Here I want that both "backticks" and "tildas" versions were rendered as code block, but only first one is rendered correctly.

[rchiodo]

This issue has been fixed in prerelease version 2023.7.43, which we've just released. You can find the changelog here: CHANGELOG.md