slack-mrkdwn

Slack のテキスト書式設定

実際の受信フィールドに合わせて、指定されたコンテンツを書式設定します。ユーザーの明示的な指示は、このスキルのガイドラインより優先されます。

レンダラーの選択

テキストと送信先フィールド／メソッドを入力として使用します。既存のペイロードから送信先を推測してください。構文に影響するにもかかわらず送信先が不明な場合は、どの表示面にテキストを送るのかを確認してください。通常の Slack メッセージで、ほかにコンテキストがない場合は、メッセージ text と mrkdwn を使用することを明記してください。

送信先	形式
メッセージ text、type: "mrkdwn" オブジェクト	Slack mrkdwn：*太字*、`<url
markdown ブロック、markdown_text、Work Object の Markdown フィールド	標準 Markdown：**太字**、[ラベル](url)
rich_text ブロック	マークアップ文字列ではなく、ネストされた要素とスタイルオブジェクト
ラベルまたは plain_text オブジェクト	リテラルテキスト

コンテンツと制御構文の保持

• mrkdwn では、信頼できない &、<、> をこの順番でエスケープします。JSON のエスケープは別途行います。verbatim: true でも、明示的な <...> 制御構文は無効になりません。
• メンションやチャンネルには実際の ID を使用します。ID がない場合は、明確にラベル付けしたテンプレート値を残すか、送信可能な出力が必要であれば確認してください。表示名から推測してはいけません。
• 意図されたメンションやリンクは保持し、広範囲への通知を新たに発生させないようにします。日付制御構文には、タイムゾーン情報を含むフォールバックが必要です。
• 指定されたフォールバックテキストは、ブロックの内容と一致する完全な形で保持します。ブロックのレンダリングによってモバイル通知テキストが表示されるとは限りません。
• フィールドごとの制限とメソッドの併用ルールを確認します。ドキュメントに記載された chat メソッドでは、非ストリーミングの markdown_text を text や blocks と併用できません。

要求された書式済み文字列、テキストオブジェクト、または修正済みペイロードを返します。意味を保持し、修正時にレンダラーの不一致があれば説明してください。書式設定タスクは投稿せずに完了できます。送信するのは、明示的に要求された場合、またはすでに許可されている場合に限ります。

参考資料

送信先または制御構文に必要な箇所だけを読みます。

タスク	参考資料
Markdown の表示面、テキストオブジェクト、リッチテキスト、Work Object のテキスト	RENDERERS.md
mrkdwn の構文、メンション、日付トークン、エスケープ	SYNTAX.md
リンク／プレビュー、parse フラグ、通知、従来形式の添付ファイル	MESSAGE-BEHAVIOR.md
フィールドと構文の簡易リファレンス	CHEATSHEET.md

表示面のサポート状況を変更する場合は、Slack の書式設定ガイドと、受信フィールド／メソッドのリファレンスを使用してください。