shuding/nextra

Feature request: Vitepress-style callout markdown support

開放

#2,606 建立於 2023年12月29日

 (4 則留言) (2 個反應) (0 位負責人)TypeScript (1,413 個分叉)user submission
feature requesthelp wanted

倉庫指標

星標
 (13,807 顆星)
PR 合併指標
 (平均合併 6天 16小時) (30 天內合併 3 個 PR)

描述

Hello! I’m a new user to Nextra but it is hands-down the best React-powered docs solution I’ve run across. I love how quickly it is to get up-and-running with almost no config, and I love how great everything looks, feels, and works ❤️.

Feature Request

Nextra has Callouts, but requires importing the component manually. Vitepress, instead, has a more automatic built-in syntax:

::: 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.
:::

This is not only easier to compose; it also works in regular ol’ .md files for more flexibility / portability. And not that the Nextra project needs to be compatible with Vitepress or anything, but in general the more parity this project has with others, the easier it is for people to migrate to it.

If this syntax seems inline with the project, I’d love to add a PR hooking up this syntax with the Callout component.

貢獻者指南