obsidian-inline-admonitions

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #golang #go #rust #deep-learning #linux #docker #java #awesome #vue #pytorch #mcp

obsidian-inline-admonitions

(★ 38)

No description available.

obsidian-inline-admonitions 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Inline Admonitions for Obsidian

This plugin will allow you to format inline codeblocks to better stand out on the page.  For example, you may want to 
have all inline codeblocks that start with "IMPORTANT" to have a red background like this.

![img.png](https://raw.githubusercontent.com/scottTomaszewski/obsidian-inline-admonitions/master/sample.png)

[inlineAdmonition_1.2.0.webm](https://github.com/scottTomaszewski/obsidian-inline-admonitions/assets/5295276/2a781588-cba0-4665-98c2-16d896cd2abe)

## Usage

To add an Inline Admonition to your note, first [create a new Inline Admonition](#Creating a new Inline Admonition) of 
the desired [type](#types).

Then add an 
[inline codeblock](https://help.obsidian.md/Editing+and+formatting/Basic+formatting+syntax#Inline+code)
with the appropriate trigger text.  For example, a [Prefix Inline Admonition](#Prefix Type) with a prefix of `IMPORTANT` will 
trigger when an inline codeblock starts with "IMPORTANT", like this:

```
Normal text `IMPORTANT - dont forget the milk!` and some more normal text
```

## Creating a new Inline Admonition

Open the "Inline Admonition" settings and click "Create New Inline Admonition" at the top to bring up a Modal to 
configure a new Inline Admonition.

![admonition-modal.png](https://raw.githubusercontent.com/scottTomaszewski/obsidian-inline-admonitions/master/admonition-modal.png)

Common settings:

- **Background Color** is the color of the Inline Admonition "bubble"
- **Background Opacity** supports transparency of the background
- **Hide Background** allows the background (including spacing) to be hidden
- **Text Color** is the text color
- **Text Opacity** supports transparency of the text
- **Type** defines how an Inline Admonition is triggered.  See the [types](#types) documentation for more details.
- **Prefix Icon** allows you to select an icon to include at the beginning of the inline admonition.
  - Note: Prefix Icons are not supported in Live Preview mode because it causes cursor navigation issues.
- **Suffix Icon** allows you to select an icon to include at the end of the inline admonition.
  - Note: Suffix Icons are not supported in Live Preview mode because it causes cursor navigation issues.
- **Font** allows selection of the font
- **Border style** chooses the border line: Default (theme), None, Solid, Dashed, or Dotted
- **Border width** sets the border thickness in pixels (applies when a border style is selected)
- **Border color** sets the border color
- **Corner radius** rounds the bubble corners (in pixels; 0 is square, higher is rounder)
- **Bold**, **Italic**, **Underline** toggle the text weight, slant, and underline

## Types

The Inline Admonition "Type" defines what triggers the codeblock to convert into an Inline Admonition.  Current supported
Types are:

- [Prefix Type](#prefix-type)
- [Suffix Type](#suffix-type)
- [Contains Type](#contains-type)
- [Regex Type](#regex-type)

### Prefix Type

Prefix Inline Admonitions trigger when a codeblock starts with specific text.

**Settings**

- `Prefix` defines the text at the start of the codeblock to trigger the Inline Admonition.
- `Hide prefix text` - if enabled, the triggering prefix text will not show in the Inline Admonition.

### Suffix Type

Suffix Inline Admonitions trigger when a codeblock ends with specific text.

**Settings**

- `Suffix` defines the text at the end of the codeblock to trigger the Inline Admonition.
- `Hide suffix text` - if enabled, the triggering suffix text will not show in the Inline Admonition.

### Contains Type

Contains Inline Admonitions trigger when a codeblock contains specific text anywhere within it.

**Settings**

- `contains` defines the text within the codeblock to trigger the Inline Admonition.

### Regex Type

Regex Inline Admonitions trigger when a codeblock matches a specific regular expression.

**Settings**

- `Regex` defines the regular expression to match against the codeblock content to trigger the Inline Admonition.
- `Sample Input` is used to help test your regex and also helps the settings display the sample.

## Notes

- The CSS of the Inline Admonitions rides on Obsidian's Tag css.  I'll clean this up in a future release.
- Saving settings will trigger a re-render of the markdown views. Its possible to avoid this and is planned for a future release
- Similar to Contexual Typography this plugin will give you some css classes that you can manually manipulate

## Future work

- Additional admonition styles
- More comprehensive CSS editing in the settings UI
- Rework the CSS-snippet generation so it no longer relies on Obsidian's private
  `app.customCss` API or writing a snippet file into the vault

See [FOLLOWUPS.md](FOLLOWUPS.md) for the detailed list of remaining work and context.

### Known Issues

- Newly created inline admonitions might not render in Live Preview.  Reload the app as a workaround
- Prefix/suffix icons are not rendered in Live Preview (they caused cursor-navigation issues)

## Development

See the [changelog](CHANGELOG.md) for changes and [FOLLOWUPS.md](FOLLOWUPS.md) for outstanding work.

### Requirements

- Requires Obsidian `1.1.0` or newer (see `minAppVersion` in `manifest.json`)

### Linting

- `npm run lint` runs ESLint with `eslint-plugin-obsidianmd` (flat config in `eslint.config.mjs`)

### Build

- `npm i` to install deps
- `npm run dev` to build and watch

### Release

Upload the files `manifest.json`, `main.js`, `styles.css` as binary attachments

obsidian-inline-admonitions

obsidian-inline-admonitions 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

obsidian-inline-admonitions

obsidian-inline-admonitions 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README