Mrkdwn

Struct Mrkdwn 

Source
pub struct Mrkdwn { /* private fields */ }
Expand description

§Markdown text

for more info, check out the slack api docs 🔗

§Reserved Characters

Slack uses the following special characters, and recommends you HTML escape them like so:

➤ Click to expand
characterhow to escape
&&
<&lt;
>&gt;

§Basic Formatting

NOTE: This is not an exhaustive list

This should, however, capture most basic use cases without requiring that you check with the Slack documentation.

For more info, please visit Slack’s docs for markdown formatting 🔗

➤ Click to expand
slack markdownformatted result
_italic_italic
*bold*bold
~strike~strike
\nline break
> a block quote
a block quote
`some code!`some code!
```multiline code\n2 lines!```multiline code
2 lines!
- li \n - li
  • li
  • li
<http://www.foo.com|link name>link name
:joy: (list from iamcal/emoji-data 🔗)😂
link to #channel: <#Cxxxxxx>#channel
link to @user: <@Uxxxxxx>@user
link to @user_group: <!subteam^xxxxxx>@user_group

Implementations§

Source§

impl Contents

Source

pub fn from_text(text: impl ToString) -> Self

Construct some markdown text from a string or string-like value

§Arguments
  • text - The text contents to render for this Text object. For some basic formatting examples, see the docs above for the Contents struct itself, or Slack’s markdown docs 🔗. There are no intrinsic length limits on this, those are usually requirements of the context the text will be used in.
§Example
use slack_blocks::compose::text::{mrkdwn, Text};

let text = mrkdwn::Contents::from_text("This link doesn't work! :tada: https://www.cheese.com")
    .with_verbatim(true);
Source

pub fn with_verbatim(self, verbatim: bool) -> Self

Sets the verbatim flag

§Arguments
  • verbatim - When set to false (as is default) URLs will be auto-converted into links, conversation names will be link-ified, and certain mentions will be automatically parsed. Using a value of true will skip any preprocessing of this nature, although you can still include manual parsing strings.
§Example
use slack_blocks::compose::text::{mrkdwn, Text};

let text = mrkdwn::Contents::from_text("This link doesn't work! :tada: https://www.cheese.com")
    .with_verbatim(true);

Trait Implementations§

Source§

impl AsRef<str> for Contents

Source§

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl Clone for Contents

Source§

fn clone(&self) -> Contents

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Contents

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for Contents

Source§

fn default() -> Contents

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for Contents

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl From<&str> for Contents

Source§

fn from(text: &str) -> Self

Converts to this type from the input type.
Source§

impl From<Contents> for ImageOrText<'static>

Source§

fn from(src: Mrkdwn) -> Self

Converts to this type from the input type.
Source§

impl From<Contents> for Text

Source§

fn from(src: Contents) -> Self

Converts to this type from the input type.
Source§

impl From<String> for Contents

Source§

fn from(text: String) -> Self

Converts to this type from the input type.
Source§

impl Hash for Contents

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for Contents

Source§

fn eq(&self, other: &Contents) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for Contents

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl TextKind<Contents> for mrkdwn

Available on crate feature blox only.
Source§

fn set_kind<M>(self, builder: TextBuilder<Text, M>) -> TextBuilder<Mrkdwn, M>

Invoke TextBuilder.mrkdwn or TextBuilder.plain
Source§

impl StructuralPartialEq for Contents

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoChild for T

Source§

fn into_child(self) -> Self

Available on crate feature blox only.
Identity function
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToSlackMarkdown for T
where T: Into<Contents>,

Source§

fn markdown(self) -> Mrkdwn

Convert to slack plain_text
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> ErasedDestructor for T
where T: 'static,