•  maegul   ( @maegul@lemmy.ml ) 
    link
    fedilink
    2
    edit-2
    1 year ago

    The problem I have with the the triple-colon block syntax (eg, see below) is that it’s really backwards incompatible.

    If you try to render such text through a normal markdown system, it’ll come out looking bad.

    I always figured a nicer way to go would be to always use any new language additions within code blocks so that the fallback for any rendering is the raw code that would ordinarily render something better looking if used with the right parser.

    For example, the second code snippet (my own made up syntax)

    :::{figure} https://source.unsplash.com/random/400x200?beach,ocean
    :name: my-fig
    :alt: Random image of the beach or ocean!
    
    Relaxing at the beach 🏝 🌊 😎
    :::
    

    My preferred syntax:

    ```{figure}
    source: https://source.unsplash.com/random/400x200?beach,ocean
    name: my-fig
    alt: Random image of the beach or ocean!
    caption: Relaxing at the beach
    ```