Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feature request: universal callouts #56

Open
nekomeowww opened this issue Jan 19, 2024 · 0 comments
Open

feature request: universal callouts #56

nekomeowww opened this issue Jan 19, 2024 · 0 comments
Assignees
Labels
enhancement New feature or request good first issue Good for newcomers good issue Good issue with descriptions or reproductions. 有着精良描述或者复现说明的 Issue help wanted Extra attention is needed

Comments

@nekomeowww
Copy link
Member

nekomeowww commented Jan 19, 2024

Goal

  1. Translate markups of container to VitePress, maybe follow the color of Obsidian for maximum compatibilities
  2. Options to adjust icons and colors
  3. While VitePress gain syntax supports from Obsidian and GFM (GitHub Flavored Markdown), Obsidian should be able to display and render both GFM and VitePress's markups as well.

Plans

  • vitepress-plugin-uncallouts
  • obsidian-plugin-uncallouts

Required to be compatible with

GFM (GitHub Flavored Markdown)

In GitHub flavored markdown, they would be declared as following:

Note

Highlights information that users should take into account, even when skimming.

Tip

Optional information to help a user be more successful.

Important

Crucial information necessary for users to succeed.

Warning

Critical content demanding immediate user attention due to potential risks.

Caution

Negative potential consequences of an action.

You can read more here: [Markdown] An option to highlight a "Note" and "Warning" using blockquote (Beta) · community · Discussion #16925

Microsoft Documentation

Note

Information the user should notice even if skimming.

Tip

Optional information to help a user be more successful.

Important

Essential information required for user success.

Caution

Negative potential consequences of an action.

Warning

Dangerous certain consequences of an action.

You can read more here: Markdown reference for Microsoft Learn - Contributor guide | Microsoft Learn

Obsidian

While Obsidian uses a similar approach with additional types supported:

Note

Lorem ipsum dolor sit amet

[!danger]
Lorem ipsum dolor sit amet

[!success]
Lorem ipsum dolor sit amet

You can read more here: Callouts - Obsidian Help

VitePress

And then VitePress uses another approach completely different:

::: info
This is an info box.
:::

::: tip
This is a tip.
:::

::: warning
This is a warning.
:::

::: danger
This is a dangerous warning.
:::

::: details
This is a details block.
:::

You can read more here: Markdown Extensions | VitePress

Other things to be considered

  • What about the other note-taking apps? How do they treat those blocks?
    • Logseq
    • Anytype
    • Notion
    • AFFiNE
    • Typora
@nekomeowww nekomeowww changed the title feature request: universal blocks feature request: universal colorized blocks Jan 19, 2024
@nekomeowww nekomeowww changed the title feature request: universal colorized blocks feature request: universal embedding blocks Jan 19, 2024
@nekomeowww nekomeowww changed the title feature request: universal embedding blocks feature request: universal callouts Jan 19, 2024
@nekomeowww nekomeowww self-assigned this Mar 7, 2024
@nekomeowww nekomeowww added enhancement New feature or request good first issue Good for newcomers help wanted Extra attention is needed good issue Good issue with descriptions or reproductions. 有着精良描述或者复现说明的 Issue labels Mar 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request good first issue Good for newcomers good issue Good issue with descriptions or reproductions. 有着精良描述或者复现说明的 Issue help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

1 participant