Replies: 275 comments 772 replies
-
How about Edit: Also, to add to this, maybe extend this behaviour to other parts such as headers in block quotes? I like to use headers because of their larger font size, but right now are they not included in this. |
Beta Was this translation helpful? Give feedback.
-
Thanks for this! Any way to customize the text? It would be very useful for non-English documents. |
Beta Was this translation helpful? Give feedback.
-
This is amazing 🔥 . This is now getting more features similar to AsciiDocs and AsciiDoctor 🎉 |
Beta Was this translation helpful? Give feedback.
-
Would love to see more callouts too for different use-cases. These 5 below might be good to start with! I'm not sure if this is only for documentation, but I would use it in general issues and other places supporting markdown. I would especially like to see one that is red in terms of "caution". That might be especially useful with enforcing a code of conduct when you've already provided a warning and would be generally helpful with RFCs(request for comments) about any major signs of caution. |
Beta Was this translation helpful? Give feedback.
-
Clever backwards compatible syntax 👍 what about changing the colour of the block quote line to blue / yellow? if you wanted to go further, you could add a background colour as well that’s a lighter shade of the corresponding colour |
Beta Was this translation helpful? Give feedback.
-
How about Check for checked information? |
Beta Was this translation helpful? Give feedback.
-
Why use the blockquote element? HTML Standard says:
|
Beta Was this translation helpful? Give feedback.
-
Hi, I like the idea but I would like to propose alternative syntax. GitHub Flavored Markdown is a superset of CommonMark and thus ideally it stays close to that if possible. The generic directives proposal for CM is already used in the ecosystem, take for instance This is how it would look:
This would mean:
|
Beta Was this translation helpful? Give feedback.
-
Nice feature! Any way to use without blockquote though? |
Beta Was this translation helpful? Give feedback.
-
More customization is always nice. What if you could specify the Github's Octoicon, color, and text? For example:
to render the alert octicon (https://primer.github.io/octicons/alert-16) with a hex color of #9a6700 and a text of "Warning":
|
Beta Was this translation helpful? Give feedback.
-
Seems like... > **Note**
> Text ...is currently rendered on the same line in readme files, instead of two separate lines like it does here in discussion comments: How it's rendered here:
How it's rendered in readme: |
Beta Was this translation helpful? Give feedback.
-
Instead, why not use highlight syntax for Add an letter and an extra Normal quote: |
Beta Was this translation helpful? Give feedback.
-
Would be cool if this can share the same syntax as Microsoft Docs "alerts" and Obsidian's "callouts". MS Docs format [1]: > [!NOTE]
> This is a note. Obsidian format [2]: > [!Note] Callout can have an _optional_ title
> Callouts can also be nested:
> > [!Hint]- You can also create foldable callouts with `+` or `-`
> > This is hidden until unfolded. [1]: https://docs.microsoft.com/en-us/contribute/markdown-reference#alerts-note-tip-important-caution-warning |
Beta Was this translation helpful? Give feedback.
-
This is awesome! 🚀 Would be great if we're offered more customization and standard syntax for these though. That'll allow many tools to auto support this.
|
Beta Was this translation helpful? Give feedback.
-
This syntax might hinder with what user actually wants to write
The user will expect this to be rendered as following because
Also is Others have proposed great alternatives like Microsoft Docs Here is my take on the syntax. Suggestions are welcomed.
|
Beta Was this translation helpful? Give feedback.
-
Hi, does gitbook support this markdown feature? or any simmilar one |
Beta Was this translation helpful? Give feedback.
-
Caution Admonitions do not work inside
|
Beta Was this translation helpful? Give feedback.
-
Check here https://github.com/opensrc0/fe-pilot?tab=readme-ov-file#usage Or try below code Note See the list of components
|
Beta Was this translation helpful? Give feedback.
-
Hello, is it known when this will be made official? :) Greetings |
Beta Was this translation helpful? Give feedback.
-
I miss question marks
|
Beta Was this translation helpful? Give feedback.
-
I was actually a bit surprised that GitHub Alerts won't be displayed with the markdown preview in VS Code, just opened a feature request on that. |
Beta Was this translation helpful? Give feedback.
-
Maybe one should be able to create ones own titles? So... its not only like this: But could also be this: For instance... by updating the code to include your custom text > [!WARNING:My own title]
> This is a custome warning text. |
Beta Was this translation helpful? Give feedback.
-
Hey everyone! Just wanted to let you know that I've submitted a feature request to integrate GitHub Alerts markdown directly into VS Code, on microsoft/vscode#209652. This enhancement proposal is currently under review for inclusion in the backlog, but it requires a minimum of 20 "thumbs-up" upvotes (👍) to progress further. If you'd like to see this feature implemented as well, please lend your support by upvoting with 👍 there! |
Beta Was this translation helpful? Give feedback.
-
Hello there ! Simple steps here (no installation required) :
// ...
"🟦 Highlights information that users should take into account, even when skimming." : {
"prefix": "md:note",
"body": [
"> [!NOTE]",
"> $1"
],
"description": "Highlights information that users should take into account, even when skimming."
},
"🟩 Optional information to help a user be more successful." : {
"prefix": "md:tip",
"body": [
"> [!TIP]",
"> $1"
],
"description": "Optional information to help a user be more successful."
},
"🟪 Crucial information necessary for users to succeed." : {
"prefix": "md:important",
"body": [
"> [!IMPORTANT]",
"> $1"
],
"description": "Crucial information necessary for users to succeed."
},
"🟧 Critical content demanding immediate user attention due to potential risks." : {
"prefix": "md:warning",
"body": [
"> [!WARNING]",
"> $1",
],
"description": "Critical content demanding immediate user attention due to potential risks."
},
"🟥 Negative potential consequences of an action." : {
"prefix": "md:caution",
"body": [
"> [!CAUTION]",
"> $1"
],
"description": "Negative potential consequences of an action."
} Then save and quit. You can now type Enjoy 🌞 ! |
Beta Was this translation helpful? Give feedback.
-
Important Hello |
Beta Was this translation helpful? Give feedback.
-
It's very cool |
Beta Was this translation helpful? Give feedback.
-
Does it consider the localization scenario? For example: > [!備註<NOTE>]
> 標明使用者即使在瀏覽時也應該考慮的資訊。 I'm not sure whether the above example follows the correct syntax, but the point is to provide an identifier to tell GitHub how to render it if the string is not English. |
Beta Was this translation helpful? Give feedback.
-
Beta Was this translation helpful? Give feedback.
-
When this will be available for GHES ? |
Beta Was this translation helpful? Give feedback.
-
I think everyone agrees that this is a useful feature, but there is a lot of negative feedback on the syntax. Is there a consensus what the syntax should be, that would be semantically correct, handle internationalization, and be considered good in the spirit of markdown? |
Beta Was this translation helpful? Give feedback.
-
Alerts are an extension of Markdown used to emphasize critical information. On GitHub, they are displayed with distinctive colors and icons to indicate the importance of the content.
An example of all five types:
Here is how they are displayed:
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.
Update - 14 November 2023
[!TIP]
and[!CAUTION]
.**Note**
isn't supported any longer.Update - 12 October 2023
Update - 28 July 2023
Thank you all once again for providing a ton of feedback. Few more changes based on that:
Update - 26 July 2023
Thanks for all the comments, we are working on a handful of fixes. One of them is to support soft line breaks in Markdown documents, so it will work the same in comments versus docs.
Update - 21 July 2023
We've made several improvements in response to your feedback:
div
instead of ablockquote
.IMPORTANT
.[!NOTE]
, has been added, which will gradually replace the old one. However, the old syntax will continue to work for some time.Thanks to all for your valuable input on this topic!
Initial - 10 May 2022
To better highlight and separate certain information from the rest in your documentation on GitHub, we now render a special and accessible note or warning blockquote in Markdown documents. We are using the existing syntax for blockquote and bold text.
This input:
Becomes:
Let us know what you think and how this helps you provide better documentation. Please note that this is a beta feature that might be subject to change.
🐳
Beta Was this translation helpful? Give feedback.
All reactions