slack-markdown-parser 2.3.1__tar.gz → 2.4.0__tar.gz

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/CHANGELOG.md

@@ -6,6 +6,23 @@ The format is based on Keep a Changelog, and the project follows Semantic Versio
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-05-14
+
+### Added
+
+- Added automatic richer Block Kit output for unambiguous standalone Markdown constructs, including image blocks, dividers, fenced code, simple quotes, and simple lists, while leaving Markdown headings in `markdown` blocks so Slack can preserve heading levels.
+
+### Documentation
+
+- Documented the Slack mobile `markdown` block limitation where list-item continuation lines are re-prefixed with the list marker, and linked the tracking issue so users can check upstream status instead of expecting a parser-side workaround.
+
+## [2.3.2] - 2026-04-17
+
+### Fixed
+
+- Stopped `preserve_visual_blank_lines` from keeping ordered-list context open after list items, including continued items, nested lists, and ordered-list paragraph interruption edge cases.
+- Avoided false-positive list-context detection for indented non-list lines and thematic breaks, so visible blank-line preservation no longer regresses on inputs like `    1. not-a-list` or `- - -`.
+
 ## [2.3.1] - 2026-04-10
 
 ### Fixed

{slack_markdown_parser-2.3.1/slack_markdown_parser.egg-info → slack_markdown_parser-2.4.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: slack-markdown-parser
-Version: 2.3.1
-Summary: Convert LLM Markdown into Slack Block Kit markdown/table messages
+Version: 2.4.0
+Summary: Convert LLM Markdown into Slack Block Kit messages
 Author: darkgaldragon
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/darkgaldragon/slack-markdown-parser
@@ -26,12 +26,12 @@ Requires-Dist: pip-audit>=2.7.0; extra == "dev"
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
 Requires-Dist: ruff>=0.6.0; extra == "dev"
-Requires-Dist: twine>=5.1.0; extra == "dev"
 Dynamic: license-file
 
 # slack-markdown-parser
 
-`slack-markdown-parser` is a Python library that converts ordinary Markdown generated by LLMs into Slack Block Kit messages built from `markdown` and `table` blocks.
+`slack-markdown-parser` is a Python library that converts general Markdown generated by LLMs into Slack Block Kit messages built from `markdown`, `table`, and selected richer blocks so the output renders cleanly in Slack.
+Basic headings and text formatting stay in `markdown` blocks, while constructs that benefit from dedicated Slack rendering, such as tables and simple standalone lists, are converted into native Block Kit blocks to produce a ChatGPT-like reading experience.
 
 ## Why this library exists
 
@@ -43,23 +43,25 @@ Many Slack AI bots have traditionally converted model output into Slack-specific
 
 ## Design approach
 
-This library uses Slack Block Kit `markdown` blocks for regular Markdown and `table` blocks for tables.
+This library combines Slack Block Kit's newer `markdown` block, `table` blocks, and richer block conversion for Markdown patterns that can be mapped safely.
 
 | Problem | Approach |
 |---|---|
-| Extra conversion work | Send ordinary Markdown through Slack `markdown` blocks without rewriting it into `mrkdwn`. |
-| Formatting instability | Prefer zero-width spaces (`U+200B`) around formatting markers, and only add visible spaces in a few language-specific cases where Slack still renders Japanese, Chinese, or Korean text incorrectly. |
-| No table syntax in `mrkdwn` | Detect Markdown tables and convert them into Slack `table` blocks, including repair of common LLM-generated table inconsistencies. |
+| Extra conversion work | Slack `markdown` blocks can render a useful subset of Markdown other than tables, so LLM output can usually be sent with minimal rewriting instead of being converted into `mrkdwn`. |
+| Formatting instability | Slack's `markdown` parser is not complete, so this library adds zero-width spaces (`U+200B`) around formatting-marker boundaries and uses visible spaces only for a few Japanese, Chinese, and Korean cases where that is still needed. This keeps emphasis stable across English and dense CJK text. |
+| No table syntax in `mrkdwn` | Detect Markdown tables and render them as Slack `table` blocks, while also repairing common LLM-generated table issues such as missing pipes. |
+| Rich LLM output | Convert standalone images, dividers, simple quotes, code fences, and simple lists into native Block Kit blocks where the Markdown structure is unambiguous. |
 
-The goal is natural rendering on Slack, not full CommonMark or HTML fidelity.
+The goal is natural rendering on Slack without exposing raw formatting markers, not full CommonMark or HTML fidelity.
 If Slack itself does not support a construct in `markdown` blocks, this library prefers safe plain-text rendering or explicit `table` blocks over aggressive rewrites into old `mrkdwn`.
 
 ## Features
 
-- Convert ordinary Markdown into Slack `markdown` blocks
+- Convert general Markdown into Slack `markdown` blocks
 - Convert Markdown tables into Slack `table` blocks
+- Promote safe standalone Markdown constructs into richer Block Kit blocks: `image`, `divider`, and `rich_text`
 - Repair common LLM table issues such as missing outer pipes, missing separator rows, mismatched column counts, and empty cells
-- Split output into multiple Slack messages when needed to satisfy Slack's "one table per message" constraint
+- Split output into multiple Slack messages when needed to satisfy Slack's "one table per message" and per-message block-count constraints
 - Remove ANSI/control characters and neutralize invalid Slack angle-bracket tokens before block generation
 - Add zero-width spaces around inline formatting markers to reduce rendering issues outside fenced code blocks, while preserving English-like punctuation-only boundaries that Slack already renders reliably
 - Add visible spaces for a small set of nested inline-code cases in dense Japanese, Chinese, and Korean text when zero-width spaces alone are not enough
@@ -74,7 +76,7 @@ The library is built around how Slack actually renders `markdown` and `table` bl
 
 Slack updated its [`markdown` block docs](https://docs.slack.dev/reference/block-kit/blocks/markdown-block/)
 and [changelog entry](https://docs.slack.dev/changelog/2026/03/06/block-kit-rich-text)
-on March 6, 2026 to describe broader support for headings, dividers, task lists,
+on March 6, 2026 as it started supporting broader Markdown features such as headings, dividers, task lists,
 native Markdown tables, and syntax-highlighted code blocks. In the Slack Web
 workspace used for this project's April 8, 2026 validation, raw `markdown`
 blocks rendered those constructs natively, including distinct heading levels
@@ -91,6 +93,7 @@ Reliable in current Slack rendering:
 - Bare URLs, `<https://...>` style links, Markdown links, reference-style links, and mailto links
 - Bullet lists, ordered lists, task lists, and simple blockquotes
 - Explicit Slack `table` blocks generated from Markdown tables
+- Explicit richer blocks generated from unambiguous Markdown, such as standalone images, code fences, simple lists, and simple quotes
 - In environments where Slack has enabled the newer renderer, raw Markdown headings, dividers, and tables inside `markdown` blocks
 
 Known Slack-side limitations:
@@ -101,19 +104,22 @@ Known Slack-side limitations:
 - Raw Markdown tables inside `markdown` blocks now render in some newer Slack environments, but explicit Slack `table` blocks remain the reliable option across workspaces and delivery paths
 - Markdown image syntax does not become an embedded image in `markdown` blocks
 - Math, raw HTML, HTML comments, `<details>`, admonition syntax, and Mermaid are rendered as plain text or code, not as rich features
+- Some newly documented Block Kit block types can be unavailable on a given `chat.postMessage` path; this library emits only a conservative subset of richer block types that has been validated through real Slack posting checks.
+- The Slack **mobile** app re-prefixes the list marker onto each continuation line of a list item inside `markdown` blocks (e.g. `1. Heading` followed by an indented paragraph shows as `1. Heading` / `1.continuation` on mobile, while Slack desktop and Slack Web render the same payload correctly). This is a Slack client-side rendering behavior, not a parser bug. Tracking: [issue #45](https://github.com/darkgaldragon/slack-markdown-parser/issues/45).
 
 What this library compensates for:
 
 - Normalizes underscore emphasis (`_..._`, `__...__`) into Slack-friendly asterisk emphasis
 - Wraps bare URLs into Slack-friendly `<https://...>` link form before sending `markdown` blocks
 - Repairs malformed LLM-generated tables before converting them into Slack `table` blocks
+- Converts unambiguous standalone Markdown constructs into native Block Kit blocks when that is safer than relying on raw `markdown` rendering
 - Keeps table-like rows inside fenced code blocks out of table normalization
 - Optionally turns internal blank lines into placeholder lines that keep paragraphs visibly separated in Slack `markdown` blocks
 - Neutralizes invalid Slack angle-bracket tokens such as raw HTML-like tags
 
 ## Requirements
 
-- Your Slack integration must support Block Kit payloads with `markdown` and `table` blocks.
+- Your Slack integration must support Block Kit payloads with `markdown`, `table`, and the richer blocks emitted by this library (`rich_text`, `image`, and `divider`).
 - This library does not help when your delivery path only accepts plain `text` or `mrkdwn` strings.
 
 ## Installation
@@ -210,8 +216,9 @@ Markdown segments with lines that contain only a non-breaking space. Those
 placeholder lines are removed again when generating preview plain text, so Slack
 notifications and logs stay close to the original Markdown source.
 The current implementation deliberately skips blank runs that sit immediately
-before setext-heading underlines or reference-link definitions, because those
-boundaries can change Markdown meaning in newer Slack Markdown rendering.
+after list-item content, before setext-heading underlines, or before
+reference-link definitions, because those boundaries can change Markdown meaning in newer
+Slack Markdown rendering or keep list formatting open in some clients.
 
 ### Utility functions
 

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/README-ja.md

@@ -1,6 +1,7 @@
 # slack-markdown-parser
 
-LLM が生成するふつうの Markdown を、Slack Block Kit（`markdown` + `table` ブロック）に変換する Python ライブラリです。
+LLM が生成する一般的な Markdown を、Slackで綺麗にレンダリングできるように、Slack Block Kit（`markdown` / `table` / 一部のリッチブロック）に変換する Python ライブラリです。
+基本的な見出しや文字修飾は `markdown` ブロックで対応し、さらにテーブルや単純な単独リストなど、Slack ネイティブの表示が有効な記法は専用の Block Kit ブロックに変換することで、ChatGPT のような読み心地に近づけています。
 
 ## 背景
 
@@ -12,23 +13,25 @@ Slack で AI BOT を動かすとき、従来は Slack 独自の `mrkdwn` 形式
 
 ## 設計方針
 
-Slack Block Kit の `markdown` ブロックと `table` ブロックを使って、上の課題に対応します。
+Slack Block Kit の比較的あたらしい `markdown` ブロック、`table` ブロック、そして安全に判定できる Markdown だけを対象にしたリッチブロック変換で、上の課題に対応できるようにしました。
 
 | 課題 | 解決手段 |
 |---|---|
-| 変換の手間 | `markdown` ブロックがふつうの Markdown を受け取れるので、LLM 出力を `mrkdwn` に書き換えずに使う |
-| 装飾の崩れ | 基本はゼロ幅スペース（`U+200B`）で装飾記号の境界を補い、それでも崩れる一部の日本語・中国語・韓国語のケースだけ可視スペースを使う |
-| テーブル非対応 | Markdown テーブルを見つけて `table` ブロックに変換し、LLM が作りがちな表の崩れも自動で補う |
+| 変換の手間 | `markdown` ブロックがテーブル以外のある程度の Markdown をレンダリングできるので、LLM 出力を `mrkdwn` に書き換えずになるべくそのまま使う |
+| 装飾の崩れ | `markdown` ブロックのMarkdownパーサーが完全ではないため、文字修飾が反映されない問題に対して、ゼロ幅スペース（`U+200B`）で装飾記号の境界を補い、それでも崩れる一部の日本語・中国語・韓国語のケースだけ可視スペースを使うことで、英語だけでなく、日本語、中国語、韓国語のレンダリングが崩れやすい言語についても、安定して装飾記号が反映される |
+| テーブル非対応 | Markdown テーブルを検知して `table` ブロックに変換してレンダリングすると同時に、LLM が起こしがちな表の崩れ（パイプ不足等）も自動で補う |
+| リッチなLLM出力 | 単独画像、水平線、単純な引用、コードフェンス、単純なリストを、意味が明確な範囲で Slack ネイティブの Block Kit ブロックへ変換する |
 
-このライブラリの目標は、CommonMark や HTML を完全再現することではなく、Slack 上で自然に読める表示を作ることです。
+このライブラリの目標は、CommonMark や HTML を完全再現することではなく、Slack 上で修飾記号を露出させず、自然に読める表示を作ることです。
 Slack の `markdown` ブロック自体が対応していない構文は、古い `mrkdwn` へ無理に書き換えるより、安全なプレーンテキスト表示や `table` ブロック化を優先します。
 
 ## 主な機能
 
-- ふつうの Markdown テキストを `markdown` ブロックに変換
+- 一般的な Markdown テキストを `markdown` ブロックに変換
 - Markdown テーブルを `table` ブロックに変換
+- 安全に判定できる単独 Markdown 構文を `image` / `divider` / `rich_text` ブロックに変換
 - LLM が生成する表で起こりやすい崩れ（外枠パイプ不足、区切り行不足、列数不一致、空セル）を補正
-- テーブルごとにメッセージを自動分割し、Slack の「1メッセージ1テーブル」制約に対応
+- 必要に応じてメッセージを自動分割し、Slack の「1メッセージ1テーブル」制約とメッセージあたりのブロック数制限に対応
 - ANSI escape / 制御文字を除去し、不正な Slack 角括弧トークンを無害化
 - フェンスドコードブロック外では、装飾記号の前後にゼロ幅スペースを入れて表示崩れを減らす
 - 日本語・中国語・韓国語の詰まった文で、インラインコードを含む装飾が崩れる一部のケースでは可視スペースを補って安定化
@@ -41,7 +44,7 @@ Slack の `markdown` ブロック自体が対応していない構文は、古
 
 本ライブラリは、Slack の `markdown` / `table` ブロックが実際にどう見えるかを前提に設計しています。
 
-Slack は 2026-03-06 に `markdown` ブロックの公式ドキュメントを更新し、見出し、水平線、タスクリスト、表、言語付きコードブロックなど、これまでより多くの Markdown 記法を案内し始めました。ただし、これらの機能は環境ごとに順番に有効化されるとも書かれています。つまり、ワークスペースやクライアントによって見え方が違う可能性があります。
+Slack は 2026-03-06 に `markdown` ブロックの公式ドキュメントを更新し、見出し、水平線、タスクリスト、表、言語付きコードブロックなど、これまでより多くの Markdown 記法をサポートし始めました。ただし、これらの機能は環境ごとに順番に有効化されるとも書かれています。つまり、ワークスペースやクライアントによって見え方が違う可能性があります。
 
 現在の Slack で比較的安定して表示されるもの:
 
@@ -49,6 +52,7 @@ Slack は 2026-03-06 に `markdown` ブロックの公式ドキュメントを
 - bare URL, `<https://...>` 形式リンク, Markdown リンク, 参照リンク, mailto リンク
 - 箇条書き, 番号付きリスト, タスクリスト, 単純な引用
 - Markdown テーブルを変換した明示的な Slack `table` ブロック
+- 単独画像、コードフェンス、単純なリスト、単純な引用から生成したリッチブロック
 - Slack 側で新しい Markdown 表示が有効な環境では、`markdown` ブロック内の見出し・水平線・表
 
 Slack 側の制約として残るもの:
@@ -59,19 +63,22 @@ Slack 側の制約として残るもの:
 - `markdown` ブロック内の生 Markdown テーブルは一部環境では表示されるが、安定性では明示的な Slack `table` ブロックの方が上
 - Markdown 画像記法は `markdown` ブロック内では埋め込み画像にならない
 - 数式, 生 HTML, HTML comment, `<details>`, admonition 記法, Mermaid は特別な表示にならず、テキストまたはコードとして出る
+- 新しく公式記載された Block Kit ブロックでも、利用する `chat.postMessage` 経路では未対応の場合があるため、このライブラリは実際の Slack 送信で確認した保守的なリッチブロックだけを出力する
+- Slack **モバイル**アプリは、`markdown` ブロック内のリスト項目に属する継続行（CommonMark で同じリスト項目に紐づくインデントされた段落）の先頭に、リストマーカーを再付加してしまう。例: `1. 見出し` の次にインデントされた継続段落を置くと、モバイルでは `1. 見出し` と `1.継続行...` のように番号が重複して表示される。Slack デスクトップ／Web は同じペイロードを正しく描画する。これはパーサー側の不具合ではなく Slack クライアントのレンダリング挙動。追跡: [issue #45](https://github.com/darkgaldragon/slack-markdown-parser/issues/45)。
 
 このライブラリが吸収するもの:
 
 - underscore 装飾 (`_..._`, `__...__`) を Slack 互換の asterisk 装飾へ正規化
 - bare URL を Slack の `<https://...>` 形式にそろえる
 - 崩れた Markdown テーブルを補って Slack `table` ブロックへ変換
+- 意味が明確な単独 Markdown 構文を、raw `markdown` 表示に頼らず Slack ネイティブの Block Kit ブロックへ変換
 - フェンスドコード内の table 風行をテーブル処理から除外
 - 必要に応じて、内部空行を補助用の行に置き換えて段落の区切りを見えやすくする
 - 生 HTML 風タグなど、Slack の特殊記法としては無効な `<...>` 形式を無害化
 
 ## 利用前提
 
-- Slack Block Kit の `blocks` で `markdown` / `table` ブロックを送信できる実装が必要です。
+- Slack Block Kit の `blocks` で `markdown` / `table` と、このライブラリが出力するリッチブロック（`rich_text`, `image`, `divider`）を送信できる実装が必要です。
 - `text` / `mrkdwn` のみ送信できる経路では利用できません。
 
 ## インストール
@@ -161,7 +168,7 @@ QA | ~~保留~~ | Team C
 
 `preserve_visual_blank_lines=True` は、非テーブル領域の内部空行を「改行を見えやすくするための補助行」に置き換えるオプションです。
 この補助行はプレビュー文字列を作るときに取り除かれるので、通知文やログは元の Markdown に近い形を保てます。
-また、setext 見出しの下線直前や参照リンク定義直前には補助行を入れず、Markdown の意味が変わらないようにしています。
+また、リスト項目の内容直後、setext 見出しの下線直前、参照リンク定義直前には補助行を入れず、Markdown の意味が変わったり一部クライアントでリスト解釈が継続したりしないようにしています。
 
 ### ユーティリティ関数（公開関数）
 

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/README.md

@@ -1,6 +1,7 @@
 # slack-markdown-parser
 
-`slack-markdown-parser` is a Python library that converts ordinary Markdown generated by LLMs into Slack Block Kit messages built from `markdown` and `table` blocks.
+`slack-markdown-parser` is a Python library that converts general Markdown generated by LLMs into Slack Block Kit messages built from `markdown`, `table`, and selected richer blocks so the output renders cleanly in Slack.
+Basic headings and text formatting stay in `markdown` blocks, while constructs that benefit from dedicated Slack rendering, such as tables and simple standalone lists, are converted into native Block Kit blocks to produce a ChatGPT-like reading experience.
 
 ## Why this library exists
 
@@ -12,23 +13,25 @@ Many Slack AI bots have traditionally converted model output into Slack-specific
 
 ## Design approach
 
-This library uses Slack Block Kit `markdown` blocks for regular Markdown and `table` blocks for tables.
+This library combines Slack Block Kit's newer `markdown` block, `table` blocks, and richer block conversion for Markdown patterns that can be mapped safely.
 
 | Problem | Approach |
 |---|---|
-| Extra conversion work | Send ordinary Markdown through Slack `markdown` blocks without rewriting it into `mrkdwn`. |
-| Formatting instability | Prefer zero-width spaces (`U+200B`) around formatting markers, and only add visible spaces in a few language-specific cases where Slack still renders Japanese, Chinese, or Korean text incorrectly. |
-| No table syntax in `mrkdwn` | Detect Markdown tables and convert them into Slack `table` blocks, including repair of common LLM-generated table inconsistencies. |
+| Extra conversion work | Slack `markdown` blocks can render a useful subset of Markdown other than tables, so LLM output can usually be sent with minimal rewriting instead of being converted into `mrkdwn`. |
+| Formatting instability | Slack's `markdown` parser is not complete, so this library adds zero-width spaces (`U+200B`) around formatting-marker boundaries and uses visible spaces only for a few Japanese, Chinese, and Korean cases where that is still needed. This keeps emphasis stable across English and dense CJK text. |
+| No table syntax in `mrkdwn` | Detect Markdown tables and render them as Slack `table` blocks, while also repairing common LLM-generated table issues such as missing pipes. |
+| Rich LLM output | Convert standalone images, dividers, simple quotes, code fences, and simple lists into native Block Kit blocks where the Markdown structure is unambiguous. |
 
-The goal is natural rendering on Slack, not full CommonMark or HTML fidelity.
+The goal is natural rendering on Slack without exposing raw formatting markers, not full CommonMark or HTML fidelity.
 If Slack itself does not support a construct in `markdown` blocks, this library prefers safe plain-text rendering or explicit `table` blocks over aggressive rewrites into old `mrkdwn`.
 
 ## Features
 
-- Convert ordinary Markdown into Slack `markdown` blocks
+- Convert general Markdown into Slack `markdown` blocks
 - Convert Markdown tables into Slack `table` blocks
+- Promote safe standalone Markdown constructs into richer Block Kit blocks: `image`, `divider`, and `rich_text`
 - Repair common LLM table issues such as missing outer pipes, missing separator rows, mismatched column counts, and empty cells
-- Split output into multiple Slack messages when needed to satisfy Slack's "one table per message" constraint
+- Split output into multiple Slack messages when needed to satisfy Slack's "one table per message" and per-message block-count constraints
 - Remove ANSI/control characters and neutralize invalid Slack angle-bracket tokens before block generation
 - Add zero-width spaces around inline formatting markers to reduce rendering issues outside fenced code blocks, while preserving English-like punctuation-only boundaries that Slack already renders reliably
 - Add visible spaces for a small set of nested inline-code cases in dense Japanese, Chinese, and Korean text when zero-width spaces alone are not enough
@@ -43,7 +46,7 @@ The library is built around how Slack actually renders `markdown` and `table` bl
 
 Slack updated its [`markdown` block docs](https://docs.slack.dev/reference/block-kit/blocks/markdown-block/)
 and [changelog entry](https://docs.slack.dev/changelog/2026/03/06/block-kit-rich-text)
-on March 6, 2026 to describe broader support for headings, dividers, task lists,
+on March 6, 2026 as it started supporting broader Markdown features such as headings, dividers, task lists,
 native Markdown tables, and syntax-highlighted code blocks. In the Slack Web
 workspace used for this project's April 8, 2026 validation, raw `markdown`
 blocks rendered those constructs natively, including distinct heading levels
@@ -60,6 +63,7 @@ Reliable in current Slack rendering:
 - Bare URLs, `<https://...>` style links, Markdown links, reference-style links, and mailto links
 - Bullet lists, ordered lists, task lists, and simple blockquotes
 - Explicit Slack `table` blocks generated from Markdown tables
+- Explicit richer blocks generated from unambiguous Markdown, such as standalone images, code fences, simple lists, and simple quotes
 - In environments where Slack has enabled the newer renderer, raw Markdown headings, dividers, and tables inside `markdown` blocks
 
 Known Slack-side limitations:
@@ -70,19 +74,22 @@ Known Slack-side limitations:
 - Raw Markdown tables inside `markdown` blocks now render in some newer Slack environments, but explicit Slack `table` blocks remain the reliable option across workspaces and delivery paths
 - Markdown image syntax does not become an embedded image in `markdown` blocks
 - Math, raw HTML, HTML comments, `<details>`, admonition syntax, and Mermaid are rendered as plain text or code, not as rich features
+- Some newly documented Block Kit block types can be unavailable on a given `chat.postMessage` path; this library emits only a conservative subset of richer block types that has been validated through real Slack posting checks.
+- The Slack **mobile** app re-prefixes the list marker onto each continuation line of a list item inside `markdown` blocks (e.g. `1. Heading` followed by an indented paragraph shows as `1. Heading` / `1.continuation` on mobile, while Slack desktop and Slack Web render the same payload correctly). This is a Slack client-side rendering behavior, not a parser bug. Tracking: [issue #45](https://github.com/darkgaldragon/slack-markdown-parser/issues/45).
 
 What this library compensates for:
 
 - Normalizes underscore emphasis (`_..._`, `__...__`) into Slack-friendly asterisk emphasis
 - Wraps bare URLs into Slack-friendly `<https://...>` link form before sending `markdown` blocks
 - Repairs malformed LLM-generated tables before converting them into Slack `table` blocks
+- Converts unambiguous standalone Markdown constructs into native Block Kit blocks when that is safer than relying on raw `markdown` rendering
 - Keeps table-like rows inside fenced code blocks out of table normalization
 - Optionally turns internal blank lines into placeholder lines that keep paragraphs visibly separated in Slack `markdown` blocks
 - Neutralizes invalid Slack angle-bracket tokens such as raw HTML-like tags
 
 ## Requirements
 
-- Your Slack integration must support Block Kit payloads with `markdown` and `table` blocks.
+- Your Slack integration must support Block Kit payloads with `markdown`, `table`, and the richer blocks emitted by this library (`rich_text`, `image`, and `divider`).
 - This library does not help when your delivery path only accepts plain `text` or `mrkdwn` strings.
 
 ## Installation
@@ -179,8 +186,9 @@ Markdown segments with lines that contain only a non-breaking space. Those
 placeholder lines are removed again when generating preview plain text, so Slack
 notifications and logs stay close to the original Markdown source.
 The current implementation deliberately skips blank runs that sit immediately
-before setext-heading underlines or reference-link definitions, because those
-boundaries can change Markdown meaning in newer Slack Markdown rendering.
+after list-item content, before setext-heading underlines, or before
+reference-link definitions, because those boundaries can change Markdown meaning in newer
+Slack Markdown rendering or keep list formatting open in some clients.
 
 ### Utility functions
 

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/docs/spec-ja.md

@@ -9,13 +9,13 @@
 
 ## 出力
 
-- Slack Block Kit ブロック（`markdown` / `table`）
-- 複数テーブル入力時は「1メッセージ1テーブル」を満たすメッセージ群
+- Slack Block Kit ブロック（`markdown`, `table`, `rich_text`, `image`, `divider`）
+- 複数テーブルや多数の昇格ブロックがある入力時は、「1メッセージ1テーブル」と Slack のメッセージあたりブロック数制限を満たすメッセージ群
 
 ## 設計目標
 
 このパーサーは、CommonMark 全体や HTML / リッチドキュメントの完全再現を目標にはしません。
-目的は、Slack Block Kit の `markdown` / `table` ブロックで送ったときに自然に読めるメッセージを作ることです。
+目的は、Slack Block Kit で送ったときに自然に読めるメッセージを作ることです。
 
 Markdown としての厳密さより Slack 上での読みやすさが重要になる場合は、Slack 上で安定して読める表現を優先します。
 
@@ -31,10 +31,10 @@ Markdown としての厳密さより Slack 上での読みやすさが重要に
 6. テーブル領域と非テーブル領域に分割する
 7. 領域ごとにブロックを作る
    - テーブル領域: セル内装飾を解析して `table` ブロックを生成。変換に失敗した場合は `markdown` ブロックに戻す
-   - 非テーブル領域: 必要に応じてゼロ幅スペースを加えた上で `markdown` ブロックを生成する
-   - `preserve_visual_blank_lines=True` の場合は、非テーブル領域の内部空行を「ノーブレークスペースだけを含む行」に置き換えてから `markdown` ブロックを作る
+   - 非テーブル領域: 安全に判定できる単独 Markdown 構文を先にリッチブロックへ変換し、残りのテキストは必要に応じてゼロ幅スペースを加えた上で `markdown` ブロックを生成する
+   - `preserve_visual_blank_lines=True` の場合は、残った `markdown` ブロックの内部空行を「ノーブレークスペースだけを含む行」に置き換えてから `markdown` ブロックを作る
 
-`convert_markdown_to_slack_messages` は上記の結果を「1メッセージ1テーブル」制約に沿って分割します。
+`convert_markdown_to_slack_messages` は上記の結果を「1メッセージ1テーブル」制約と Slack のメッセージあたりブロック数制限に沿って分割します。
 `convert_markdown_to_slack_payloads` は、同じ分割結果に `chat.postMessage.text` 用のプレビュー文字列を付けた送信データを返します。
 
 ## 実測ベースの Slack の挙動
@@ -49,6 +49,7 @@ Markdown としての厳密さより Slack 上での読みやすさが重要に
 - bare URL, `<https://...>` 形式リンク, Markdown リンク, 参照リンク, mailto リンク
 - 箇条書き, 番号付きリスト, タスクリスト, 単純な1段引用
 - Slack `table` ブロック
+- 意味が明確な単独 Markdown 構文から生成した Slack ネイティブのリッチブロック
 
 Slack は 2026-03-06 に `markdown` ブロックの公式ドキュメントを更新し、これまでより多くの Markdown 記法を案内し始めました。本プロジェクトの 2026-04-08 の Slack Web 実測では、raw の `markdown` ブロックで次を確認しています。
 
@@ -73,6 +74,13 @@ Slack は 2026-03-06 に `markdown` ブロックの公式ドキュメントを
 - `_..._` / `__...__` を Slack 互換の `*...*` / `**...**` に正規化する
 - bare URL を Slack で安定しやすい `<https://...>` 形式にそろえる
 - 崩れた Markdown テーブルを補って `table` ブロックへ変換する
+- 意味が明確な単独 Markdown 構文を Slack ネイティブのブロックへ変換する
+  - 単独行の画像構文 `![alt](https://...)` → `image`
+  - 水平線 → `divider`
+  - フェンスドコード → `rich_text_preformatted`
+  - 単純な1段引用 → `rich_text_quote`
+  - 単純な箇条書き / 番号付きリスト → `rich_text_list`
+    - リストは、テキスト領域の先頭または空行の直後から始まり、連続する非空行がすべてリスト項目で、1〜3スペースの曖昧なネストインデントや Markdown バックスラッシュエスケープに依存せず、直後にインデント付きの継続段落がない場合だけ昇格する
 - フェンスドコード内の table 風行をテーブル解析対象から除外する
 - 内部空行を、必要に応じて段落区切りを見えやすくする補助行へ置き換える
 - `<foo>` や生 HTML 風タグのような、Slack の特殊記法としては無効な `<...>` 形式を無害化する
@@ -205,6 +213,7 @@ LLM は外枠パイプの省略、区切り行の欠落、列数の不一致な
 - 見える行に挟まれた内部空行だけを書き換える
 - 先頭・末尾の空行のまとまりはそのまま残す
 - table 領域には適用しない
+- リスト項目の内容直後の空行はそのまま残す
 - setext 見出しの下線直前の空行はそのまま残す
 - 参照リンク定義直前の空行はそのまま残す
 - プレビュー文字列と `blocks_to_plain_text` では補助用のマーカーを除去し、元の空行構造に戻す

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/docs/spec.md

@@ -9,13 +9,13 @@ This document describes how `slack-markdown-parser` converts Markdown into Slack
 
 ## Output
 
-- Slack Block Kit blocks (`markdown` / `table`)
-- When the input contains multiple tables, a list of messages that satisfies the "one table per message" rule
+- Slack Block Kit blocks (`markdown`, `table`, `rich_text`, `image`, and `divider`)
+- When the input contains multiple tables or many promoted blocks, a list of messages that satisfies the "one table per message" rule and Slack's per-message block-count limit
 
 ## Design target
 
 This parser does not try to reproduce full CommonMark, HTML, or rich-document rendering.
-Its goal is to produce Slack messages that read naturally when delivered through Slack Block Kit `markdown` and `table` blocks.
+Its goal is to produce Slack messages that read naturally when delivered through Slack Block Kit blocks.
 
 When exact Markdown fidelity conflicts with Slack readability, readable Slack output takes priority.
 
@@ -31,10 +31,10 @@ When exact Markdown fidelity conflicts with Slack readability, readable Slack ou
 6. Split the text into table regions and non-table regions
 7. Build blocks for each region:
    - Table regions: parse inline cell styling and generate a `table` block. If conversion fails, such as when there are fewer than two candidate lines or the parse result is empty, fall back to a `markdown` block.
-   - Non-table regions: add zero-width spaces where needed and generate a `markdown` block.
-   - If `preserve_visual_blank_lines=True`, replace internal blank lines in non-table regions with lines that contain only a non-breaking space before emitting the `markdown` block.
+   - Non-table regions: first promote safe standalone Markdown constructs into richer Block Kit blocks, then add zero-width spaces where needed and generate `markdown` blocks for the remaining text.
+   - If `preserve_visual_blank_lines=True`, replace internal blank lines in remaining `markdown` blocks with lines that contain only a non-breaking space before emitting the `markdown` block.
 
-`convert_markdown_to_slack_messages` then splits the resulting block list to satisfy the "one table per message" rule.
+`convert_markdown_to_slack_messages` then splits the resulting block list to satisfy the "one table per message" rule and Slack's per-message block-count limit.
 `convert_markdown_to_slack_payloads` returns the same split blocks plus preview `text` values ready for `chat.postMessage`.
 
 ## How Slack behaved in testing
@@ -49,6 +49,7 @@ The behaviors below are based on practical validation against real Slack clients
 - Bare URLs, `<https://...>` style links, Markdown links, reference-style links, and mailto links
 - Bullet lists, ordered lists, task lists, and simple one-level blockquotes
 - Slack `table` blocks
+- Native richer blocks generated from unambiguous standalone Markdown constructs
 
 Slack published updated `markdown` block documentation and a changelog entry on March 6, 2026. In the Slack Web workspace validated for this project on April 8, 2026, raw `markdown` blocks rendered:
 
@@ -73,6 +74,13 @@ Slack still controls when those newer features appear and how they look, so trea
 - `_..._` and `__...__` are normalized into Slack-friendly `*...*` and `**...**`
 - Bare URLs are wrapped into Slack-friendly `<https://...>` form before `markdown` block delivery
 - Malformed Markdown tables are repaired before `table` block generation
+- Unambiguous standalone Markdown constructs are promoted into native Slack blocks:
+  - standalone image syntax `![alt](https://...)` to `image`
+  - thematic-break lines to `divider`
+  - fenced code blocks to `rich_text_preformatted`
+  - simple one-level quotes to `rich_text_quote`
+  - simple bullet and ordered lists to `rich_text_list`
+    - Lists are promoted only when the list starts at the beginning of the text region or after a blank line, each non-blank line in the run is a list item, the list does not use ambiguous 1-3-space nested indentation, the item text does not rely on Markdown backslash escapes, and the run is not followed by an indented continuation paragraph.
 - Table-like rows inside fenced code blocks are kept out of table parsing
 - Internal blank lines can optionally be rewritten into placeholder lines so Slack keeps visible paragraph separation
 - Unsupported Slack angle-bracket tokens such as `<foo>` or raw HTML-like tags are neutralized
@@ -207,6 +215,7 @@ This workaround is intentionally narrow:
 - Only blank lines between visible lines are rewritten
 - Leading and trailing blank runs are left untouched
 - Table segments are not modified by this option
+- Blank runs immediately after list-item content are left untouched
 - Blank runs immediately before setext-heading underlines are left untouched
 - Blank runs immediately before reference-link definitions are left untouched
 - Preview text and `blocks_to_plain_text` remove those placeholder markers again, preserving the original blank lines in plain-text output

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "slack-markdown-parser"
-version = "2.3.1"
-description = "Convert LLM Markdown into Slack Block Kit markdown/table messages"
+version = "2.4.0"
+description = "Convert LLM Markdown into Slack Block Kit messages"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
@@ -33,7 +33,6 @@ dev = [
   "pytest>=8.0.0",
   "pytest-cov>=5.0.0",
   "ruff>=0.6.0",
-  "twine>=5.1.0",
 ]
 
 [project.urls]
@@ -57,4 +56,7 @@ target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B"]
-ignore = ["E501", "UP006", "UP035", "UP045"]
+ignore = ["E501"]  # line length is enforced by black
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

{slack_markdown_parser-2.3.1 → slack_markdown_parser-2.4.0}/slack_markdown_parser/__init__.py

@@ -1,6 +1,6 @@
 """slack-markdown-parser public package API."""
 
-__version__ = "2.3.1"
+__version__ = "2.4.0"
 __license__ = "MIT"
 
 from .converter import (