发送Markdown

Telegram 还支持 Markdown 和 HTML 类型的文本消息。本章我们将实现/help指令，它会将帮助信息以 Markdown 格式发送给用户。

本章代码在05/发送 Markdown分支。

Telegram 只是有限支持 Markdown 和 HTML，即便如此，我们也可以利用这有限的支持发送格式多样的文本消息。

Markdown 消息其实也是文本消息，所以它调用的 API 和发送普通文本消息的 API 是一样的。

定义 Markdown 消息类型

我们需要给MsgType增加一个枚举值：

// src/types/mod.rs

pub enum MsgType {
    Text(String),
    Photo(String),
    Markdown(String),
}

调用 API 的函数

pub async fn send_markdown_message(token: &str, chat_id: u64, text: String) -> Result<Response> {
    let data = request::MarkdownMessage {
        chat_id,
        text,
        parse_mode: "MarkdownV2".to_string(),
    };
    invoke_api(&data, "sendMessage", token).await
}

这里指明了 parse_mode 为 MarkdownV2，这样 Telegram 就会使用 Markdown 来解析文本消息了。

// src/types/request.rs

#[derive(Serialize, Debug)]
pub struct MarkdownMessage {
    pub chat_id: u64,
    pub text: String,
    pub parse_mode: String,
}

返回 Markdown 消息内容

// src/handler/command.rs

pub fn help(msg: Option<&str>) -> String {
    let header = match msg {
        Some(txt) => format!("你输入的 `{}` 有误", txt),
        None => "".to_string(),
    };
    let body = r#"
__使用帮助__
`/website`：访问官方网站
`/logo`：获取官方LOGO
`/help`：显示帮助信息
        "#;
    format!(r#"{}{}"#, header, body)
}