Markdown: incorrect/incomplete advice on iPassword help page?

jimthing
jimthing
Community Member
edited February 2019 in Lounge

I think your Markdown help page is possibly wrong or incomplete?
https://support.1password.com/markdown

I notice when I do a dash'd list, e.g:

- something
- something more
- something else
- something other

on hitting Save it ends up looking like:

• something
• something more
• something else
• something other

But your support page says that it's only an asterisks (*) that should make dots (•) on save:
● Bulleted list | * List item

I'm not that au fait with Markdown. Are there different versions on products that use it, or is this expected behaviour, just without the help page mentioning it?


1Password Version: Not Provided
Extension Version: Not Provided
OS Version: Not Provided
Sync Type: Not Provided

Comments

  • XIII
    XIII
    Community Member

    From John Gruber's Markdown Syntax Documentation:

    Unordered lists use asterisks, pluses, and hyphens — interchangably — as list markers

  • Yep; this is expected behavior. I'll file an issue for the documentation team to take a look. Thanks. :)

    Ben

    ref: web/support.1password.com#1880

  • jimthing
    jimthing
    Community Member

    From John Gruber's Markdown Syntax Documentation:

    Unordered lists use asterisks, pluses, and hyphens — interchangably — as list markers

    Thanks. Yeah I know Gruber invented it ;-)

    Trouble is that the average user here isn't gonna know what's wrong, if it's not on the 1Password chart for them to see – or perhaps additionally on that page, simply add a link to Gruber's original Markdown Syntax Documentation page?

  • simply add a link to Gruber's original Markdown Syntax Documentation page?

    The difficulty with that is we (intentionally) don't support the full scope of markdown. We only support a subset.

    Trouble is that the average user here isn't gonna know what's wrong, if it's not on the 1Password chart for them to see

    That is a very valid point and I've asked our docs folks to look at how we can improve this.

    Ben

  • khad
    khad
    1Password Alumni

    Added a note to Format your secure notes with Markdown:

    Asterisks (*), hyphens (-), or plus signs (+) all work.

This discussion has been closed.