https://github.com/alan-null/joplin-plugin-github-alerts

Markdown extension based on the blockquote syntax that you can use to emphasize critical information. They are displayed with distinctive colors and icons to indicate the significance of the content.
https://github.com/alan-null/joplin-plugin-github-alerts

joplin joplin-plugin markdown markdown-it

Last synced: about 1 month ago
JSON representation

Markdown extension based on the blockquote syntax that you can use to emphasize critical information. They are displayed with distinctive colors and icons to indicate the significance of the content.

• Host: GitHub
• URL: https://github.com/alan-null/joplin-plugin-github-alerts
• Owner: alan-null
• License: mit
• Created: 2025-01-04T20:40:43.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2025-01-13T20:39:03.000Z (4 months ago)
• Last Synced: 2025-04-14T04:09:01.784Z (about 1 month ago)
• Topics: joplin, joplin-plugin, markdown, markdown-it
• Language: TypeScript
• Homepage:
• Size: 272 KB
• Stars: 7
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Github Alerts (callouts)

[![Joplin](https://img.shields.io/npm/v/joplin-plugin-github-alerts?logo=joplin&label=Joplin)](https://joplinapp.org/plugins/plugin/com.github.alan-null.joplin-plugin-github-alerts/)  [![GitHub](https://img.shields.io/github/v/release/alan-null/joplin-plugin-github-alerts?label=GitHub%20Release&logo=github)](https://github.com/alan-null/joplin-plugin-github-alerts/releases/latest) [![npm](https://img.shields.io/npm/v/joplin-plugin-github-alerts?label=NPM%20Package&logo=npm)](https://www.npmjs.com/package/joplin-plugin-github-alerts)

**[GitHub Alerts](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/)** or **[callouts](https://docs.readme.com/rdmd/docs/callouts)** are a Markdown extension based on the blockquote syntax that you can use to emphasize critical information.

They are displayed with distinctive colors and icons to indicate the significance of the content.

![demo](images/demo.png)

## Usage

Markdown example:

```

> [!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.

```

### Customization

Alternative titles are supported by appending them to the marker like this:

```markdown

> [!note] Nota bene

> The custom title will replace the regular title.

```

## Functionality

This plugin transforms the following markdown:

```markdown

> [!NOTE]

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

```

to the following HTML:

```html



  
Note



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



```


Which is compatible with GitHub's output.

## Acknowledgements

This project makes use of the following libraries/code:

- **[markdown-it-github-alerts]()** by [**antfu**](https://github.com/antfu)

  *Support GitHub-style alerts for markdown-it.*

Thank you for your valuable contributions to the OS community!

## License

[MIT License](LICENSE.md) © Alan Płócieniak