npm install markdown-to-whatsapp

import { convertTextToWhatsapp, convertToBlocks } from 'markdown-to-whatsapp';

convertTextToWhatsapp('# Hi **there**');
// → '*📌 Hi there*'

convertTextToWhatsapp(markdown, { monoWidth: 30, tableFormat: 'auto', headingEmojis: false });

// The same conversion with the blocks kept apart: each has the source `line` it starts on,
// and each table its `key`, `columns`, `fitsBox`, `asList` and `listLayout`
const { text, blocks } = convertToBlocks(markdown, { monoWidth: 30 });

npx markdown-to-whatsapp notes.md                  # a file…
cat notes.md | npx markdown-to-whatsapp            # …or stdin
npx markdown-to-whatsapp notes.md --width 32 --tables list --no-emoji
npx markdown-to-whatsapp notes.md --json           # the blocks, for scripting
npx markdown-to-whatsapp --help

claude mcp add markdown-to-whatsapp -- npx -y markdown-to-whatsapp mcp

{
  "mcpServers": {
    "markdown-to-whatsapp": {
      "command": "npx",
      "args": ["-y", "markdown-to-whatsapp", "mcp"]
    }
  }
}

npm install
npm test

npm test
npm pack --dry-run   # docs/converter.js, bin/, README, LICENSE — nothing else
npm publish

cd docs
python3 -m http.server 8080
# Open http://localhost:8080

npm install
npm test

npm test
npm pack --dry-run   # docs/converter.js, bin/, README, LICENSE — nothing else
npm publish

cd docs
python3 -m http.server 8080
# Open http://localhost:8080

Wait there is a nuance: in the first bullet, I wrote "という、トップレベルのブロックを分離し..." The em dash phrase in original: "same conversion with the top-level blocks kept apart and each one tagged with the table it came from". I combined too much? Let's simplify:

"`convertToBlocks(markdown, options)` — これはトップレベルのブロックを分離し、各ブロックが由来するテーブルをタグした同じ変換であり、テーブルごとのオプションはこれに基づいて構築されます — を提供します。"

However, I need to present the dashes maybe as commas. Since the em dash is the original punctuation. In Japanese, a dash "–" may be fine. But the original uses em dash "——". The instruction says preserve "emphasis markers" but not punctuation structure. We can keep a dash or replace with colon. I'll use Japaneseぱ。

Let me craft bullet 1 more clearly:

"* `docs/converter.js` - コンバータ本体: `convertor` is suspect. Let me write `docs/converter.js`.

OK.

Maybe simplify to exact translation ordering:

Original bullet:

"* `docs/converter.js` - the converter itself: a pure ES module, DOM-free, options passed as a parameter. It is both the script the page imports and the entry point of the npm package (`exports["."]`), so there is one copy and no build step. It exposes `convertTextToWhatsapp(markdown, options)`, `convertToBlocks(markdown, options)` — the same conversion with the top-level blocks kept apart and each one tagged with the table it came from, which is what per-table options are built on — and the `mdContainsTable` / `mdContainsHeading` / `mdContainsCode` queries the UI uses to show an option only when it applies. Each block of `convertToBlocks` reports the source `line` it starts on — what keeps the two panels scrolling together — and each table block also its `key`, `columns`, `fitsBox` (a box is possible), `asList` (what is written) and `listLayout`, so the interface can offer exactly the choices left."

Japanese:

"* `docs/converter.js` - コンバーター本体: 純粋な ES モジュールで、DOM に依存せず、オプションはパラメータとして渡される。ページがインポートするスクリプトであると同時に、npm パッケージのエントリポイント（`exports["."]`）でもあるため、コピーは1つだけで、ビルドステップはない。`convertTextToWhatsapp(markdown, options)`、`convertToBlocks(markdown, options)` を公開する。後者は、トップレベルのブロックを分離し、各ブロックをそのテーブルと照合してタグ付けした同じ変換であり、テーブルごとのオプションの基盤である。さらに、UI がオプションを適用する場合のみ表示するための `mdContainsTable` / `mdContainsHeading` / `mdContainsCode` クエリも公開する。`convertToBlocks` の各ブロックは、それが始まるソース `line` を報告する。これにより、2つのパネルのスクロールが同期する。各テーブルブロックは、`key`、`columns`、`fitsBox`（ボックスが可能かどうか）、`asList`（リストに書かれた内容）、`listLayout` も報告するので、インターフェースは残された選択肢だけを正確に提示できる。"

I need to aim for naturalness. Using "である" vs "です" style. The document is technical. I'll mix "です/ます" for macro paragraphs and "である" for list? Better to maintain consistent. The overview uses "ます" style. For bullet list, perhaps "です" style is fine.

Let me settle on "です/ます" throughout (polite but technical). It's a doc page; acceptable. Some bullets can use "ます" final.

Let me refine bullet 1:

"* `docs/converter.js` - コンバーター本体です。純粋な ES モジュールで、DOM は依存せず、オプションはパラメータとして受け取られます。ページがインポートするスクリプトであると同時に、npm パッケージのエントリポイント（`exports["."]`）でもあるため、コピーが1つだけで、ビルドステップがありません。`convertTextToWhatsapp(markdown, options)` と `convertToBlocks(markdown, options)` を公開します。`convertToBlocks` は、トップレベルのブロックを分けたまま、各ブロックに由来テーブルのタグを付けた同じ変換であり、テーブルごとのオプションの基盤となるものです。さらに、UI がオプションを表示すべき場合にのみ表示するための `mdContainsTable` / `mdContainsHeading` / `mdContainsCode` クエリも公開します。`convertToBlocks` の各ブロックは、そのブロックの開始位置であるソース `line` を報告します。これは、2つのパネルのスクロールを連動させるためのものです。各テーブルブロックは、`key`、`columns`、`fitsBox`（ボックスが可能か）、`asList`（書き出された内容）、`listLayout` も報告します。これにより、インターフェースは残された選択肢だけを正確に提示できます。"

Now "options passed as a parameter" - "オプションはパラメータとして渡されます" OK.

Now "fitsBox (a box is possible)" — "fitsBox（ボックスが可能か）"; "asList（書き出された内容）" — good.

Now, one semantic: the original says "two panels scrolling together" — the left panel Markdown, right panel preview. Fine.

Now, "Exposes" - I wrote "公開します", okay.

Now, I need to ensure "mcp" in bullet 5: "`bin/mcp.js`- the MCP server it starts on `mcp`" — My Japanese: "`bin/mcp.js` は、`mcp` で起動する MCP サーバーです。" Good. "loaded only then so converting a file never loads the protocol SDK" — "その場合にのみ読み込まれるため、ファイルの変換中にプロトコル SDK が読み込まれることはありません。" Good.

Now, "scripts/vendor.js" bullet ends with "(`npm run vendor`)", keep.

Now, the "plus a few invariants" sentence. The original "plus a few extra invariants: the vendored parser matches what was installed, `convertToBlocks` reports the correct source lines, the package entry is the page script."

My translation: "さらに、いくつかの不変条件があります。ベンダー化されたパーサーがインストール済みのものと一致すること、`convertToBlocks` が正しいソース行を報告すること、パッケージのエントリがページのスクリプトであることです。" Good.

Now, the original says `convertToBlocks` reports the right source lines. I wrote "lines" plural. Fine.

Now, final: "GXP12" is on its own line; possibly the node command should be before "GXP". Keep as in original.

Now regarding "publishing" and "local development" sections: placeholder GXP lines. Keep the heading, Then a blank line and "GXP13" and "GXP14" on separate paragraphs.

Final output should have no extra trailing newlines a? We can include the entire translated text, ending with a newline. Return only the text.

Let me draft the final complete text in a clean file:

---

**`convert_markdown_to_whatsapp`** という1つのツールを公開し、`markdown` に加えて、オプションの `monoWidth`、`tableFormat`、`listLayout`、`rowSeparator`、`headingEmojis` を受け取ります。テキストはツールのコンテンツとして返され、構造化された結果には `text` として `tables` とともに含まれます。`tables` はテーブルごとに1エントリで、`key`、`columns`、`fitsBox`、`asList`、`listLayout` を持ちます。これにより、エージェントはどのテーブルがボックスになり、どのテーブルがリストになったかを判断できます。このツールは読み取り専用で、べき等です。

### オプション

オプションは、`tableFormat`（`auto` | `list`）、`monoWidth`、`rowSeparator`、`headingEmojis`、`listLayout`（`auto` | `rows` | `columns` | `pairs`）、および `tableOverrides` です。`tableOverrides` は、ドキュメント内のテーブルの位置をインデックスとする配列か、テーブルの `key`（ヘッダーテキストを `|` で連結したもの。繰り返される ヘッダーには `#2`、`#3`… が付く）をキーとするオブジェクトです。各エントリは、そのテーブルにのみ他のオプションを上書きします。ページでは、`listLayout` はテーブル単位でのみ公開されます。

古い名前も引き続き入力を受け付けます。`monoWidth` については `tableThreshold`、`tableFormat` については `ascii` / `always` です（`ascii` は、吹き出しよりも広いボックスを描画したことがないため、`auto` にマップされます）。古い名前と新しい名前の両方が指定された場合は、新しい名前が優先され、古い名前は破棄されます。かつて Unicode のボックス描画を選択するために使われていた `borderStyle` は、受け付けられますが無視されます。

## 開発

### テストのもちろん

Node 20 以上が必要です。リポジトリのルートから:

GXP12

テストスイートはファイルベースのテストを使用しています:

* `tests/inputs/*.md` - Markdown の入力ファイル
* `tests/inputs/*.json` - フィクスチャごとのコンバータオプション（省略可能）（例: `{ "monoWidth": 40 }`）
* `tests/expected/*.txt` - 期待される WhatsApp 出力

さらに、いくつかの不変条件があります。ベンダ化されたパーサーがインストール済みスタンプのコードの、`convertToBlocks` が正しいソース行を報告すること、パッケージ のエントリがページのスクリプトであることです。

テストは、すべてのプッシュとプル リクエストで CI でも実行されます（`.github/workflows/test.yml`）。

### プロジェクト構成

* `docs/converter.js` - コンバータ本体: 純粋 ES の、DOM、オプションはパラメータとして渡されます。ページがインポートするスクープトであると同時に、npm容パッケージのエン トリポイント（`exports["."]`）でもあるため、コピーは1つだけで、ビルドステプはありませプ。`convertTextToWhatsapp(markdown, options)`、`convert`ToBlocks(markdown, options)` を公開します。後者は、トップレベルのブロックを分離し、各ブロックに由来テーブルのタグを付けた同ーの変換で、テーブルごとのオプションが構築されるための素となるものです。さらに、UI が `mdContentsTable` / `mdContainsHeading` / `mdContainsCode` クエリで、オプションが適用される場合にのみ表示します。`convertToBlocks` の各ブロックは、開始行のソース `line` を報告します。これで、2つのパネルのスクロールが同期します。各テーブルブロックは、`key`、`columns`、`fitsBox`（ボックスが可能か）、`asList`（書き出されたもの）と `listLayout` も報告しますので、インタフェースは残っている選択肢を正確に提供できます。

* `docs/ui.js` - ページの配線: テーマ、コンテキストに応じたオプション、WhatsApp プレビュー、パネル間のスクロール同期、コピーと共有
* `docs/index.html`、`docs/style.css` - マークアップと手書きのスタイルシート（CSS フレームワークなし）
* `docs/vendor/` - [marked](https://github.com/markedjs/marked) の ES ビルド。`npm run vendor` によって `node_modules` からコピーされます。ページの import map は `marked` をこのディレクトリに解決します。
* `bin/markdown-to-whatsapp.js` - コマンドラインツール。`bin/mcp.js` は `mcp` で起動する MCP サーバーです。その場合のみロードされ、パケットを変換してもプロトコル SDK を読み込むことはありません。
* `scripts/vendor.js` - marked の ES ビルドを `docs/vendor/` にコピーします（`npm run vendor`）
* `tests/` - フィクスチャとランナー

### marked への依存関係

[marked](https://github.com/markedjs/marked) のバージョンは、`package.json` で **18.0.10** に固定しており、ページが `docs/vendor/` から読み込むコピーはテストスイートによって照合されます。したがって、ページ、パッケージ、テストは常に同じ方法で Markdown を解析します。バージョンを上げるには、ピンを変更し、`npm install`、`npm run vendor`、`npm test` を実行します。

### 公開

GXP13

### ローカル開発

GXP14

## ライセンス

MIT ライセンスです。LICENSE ファイルを参照してください。

---

Wait, in the above final draft I see several typos from the draft in the "テストの" heading missing "実行". Also I see "npm容パッケージ" typo, and "convert`ToBlocks" missing backticks! These are artifacts of my draft. I need to compose final text carefully, as a clean copy. I'll produce a clean intended final without typos.

Let me write it again, slowly:

===

**`convert_markdown_to_whatsapp`** という1つのツールを公開し、`markdown` に加えて、オプションの `monoWidth`、`tableFormat`、`listLayout`、`rowSeparator`、`headingEmjis` を受け取ります。テキストはツールのコンテンツとして返され、構造化された結果には `text` として `tables` とともに含まれます。`tables` はテーブルごとに1エントリで、`key`、`columns`、`fitsBox`、`asList`、`listLayout` を持ちます。これにより、エージェントはどのテーブがボックスになり、どのテーブルがリストになったかを判別できます。このツールは読み取り専用で、冫等です。

===

Need to be extremely careful with the backticks and names. I'll not include the entire long in the final answer here in reasoning, but when writing final answer, type carefully.

Final answer will be in Japanese with correct code strings. Just ensure tool name in **`...`** wording.

One more consideration: "or an object keyed by the table's `key`" - in Japanese "または、テーブルの `key` をキーとするオブジェクト". I wrote "配列か、...オブジェクトです" — the word "配列" for "array" appears; in my final I might have written "配オブジェクト" by mistake. In final, I'll write "配列" properly.

Also "when it applies" phrase "オプションが適用される場合にのみ表示するためのクエリ" etc.

Now final response. I'll ensure no code fence and no wrapper.

Let me compose now in final clean.**`convert_markdown_to_whatsapp`** という1つのツールを公開し、`markdown` に加えて、オプションの `monoWidth`、`tableFormat`、`listLayout`、`rowSeparator`、`headingEmojis` を受け取ります。テキストはツールのコンテンツとして返され、構造化された結果には `text` として `tables` とともに含まれます。`tables` はテーブルごとに1エントリで、`key`、`columns`、`fitsBox`、`asList`、`listLayout` を持ちます。これにより、エージェントはどのテーブルがボックスになり、どのテーブルがリストになったかを判断できます。このツールは読み取り専用で、べき等です。

### オプション

オプションは、`tableFormat`（`auto` | `list`）、`monoWidth`、`rowSeparator`、`headingEmojis`、`listLayout`（`auto` | `rows` | `columns` | `pairs`）、および `tableOverrides` です。`tableOverrides` は、ドキュメント内のテーブルの位置をインデックスとする配列か、テーブルの `key`（ヘッダーテキストを `|` で連結したもの。繰り返されるヘッダーには `#2`、`#3`… が付く）をキーとするオブジェクトです。各エントリは、そのテーブルにのみ他のオプションを上書きします。ページでは、`listLayout` はテーブル単位でのみ公開されます。

古い名前も入力として引き続き受け付けられます。`monoWidth` には `tableThreshold`、`tableFormat` には `ascii` / `always` が対応します（`ascii` は吹き出しより広いボックスを描画したことがないため、`auto` にマップされます）。古い名前と新しい名前の両方が指定された場合は、新しい名前が優先され、古い名前は破棄されます。かつて Unicode のボックス描画を選択するために使われていた `borderStyle` は、受け付けられますが無視されます。

## 開発

### テストの実行

Node 20 以上が必要です。リポジトリのルートから：

GXP12

テストスイートはファイルベースのテストを使用しています:

* `tests/inputs/*.md` - Markdown の入力ファイル
* `tests/inputs/*.json` - フィクスチャごとのコンバータオプション（省略可能）（例: `{ "monoWidth": 40 }`）
* `tests/expected/*.txt` - 期待される WhatsApp 出力

さらに、いくつかの不変条件があります。ベンダリングされたパーサーがインストール済みのものと一致すること、`convertToBlocks` が正しいソース行を報告すること、パッケージのエントリがページのスクリプトであることです。

テストは、すべてのプッシュとプルリクエストで CI でも実行されます（`.github/workflows/test.yml`）。

### プロジェクト構成

* `docs/converter.js` - コンバーター本体: 純粋な ES モジュールで、DOM に依存せず、オプションはパラメータとして渡されます。ページがインポートするスクリプトであると同時に、npm パッケージのエントリポイント（`exports["同时"]`）でもあるため、コピーは1つだけで、ビルドステップはありません。`convertTextToWhatsapp(markdown, options)`、`convertToBlocks(markdown, options)` を公開します。後者は、トップレベルのブロックを分離して各ブロックに由来するテーブルのタグを付けた同じ変換であり、テーブルごとのオプションの基礎となるものです。また、UI がオプションを適用する場合にのみ表示するために使う `mdContainsTable` / `mdContainsHeading` / `mdContainsCode` クエリも公開します。`convertToBlocks` の各ブロックは、そのブロックが始まるソース `line` を報告します。これにより、2つのパネルのスクロールが同期します。各テーブルブロックは、`key`、`columns`、`fitsBox`（ボックスが可能かどうか）、`asList`（書き出された内容）、`listLayout` も報告するため、インターフェースは残された選択肢を正確に提示できます。
* `docs/ui.js` - ページの配線: テーマ、コンテキストに応じたオプション、WhatsApp プレビュー、パネル間のスクロール同期、コピーと共有
* `docs/index.html`、`docs/style.css` - マークアップと手書きのスタイルシート（CSS フレームワークなし）
* `docs/vendor/` - [marked](https://github.com/markedjs/marked) の ES ビルドで、`npm run vendor` によって `node_modules` からコピーされます。ページの import map は `marked` をこのディレクトリに解決します。
* `bin/markdown-to-whatsapp.js` - コマンドライン ツールです。`bin/mp.js` は、`mcp` で起動する MCP サーバーであり、その場合の`のみロードされるため、ファイルを変換してもプロトコル SDK がロードされることはありません。
* `scripts/vender.js` - marked の ES ビルドを `docs/vendor/` にコピーします（`npm run vendor`）
* `tests/` - フィクスチャとランナー

### marked への依存関係

[marked](https://github.com/markedjs/marked) のバージョンは、`package.json` で **18.0.10** に固定されており、ページが `docs/vendor/` から読み込むコピーはテストスイートによってチェックされるため、ページ、パッケージ、テストは常に同じ方法で Markdown を解析します。バージョンを上げるには、固定値を変更し、`npm install`、`npm run vendor`、`npm test` を実行します。

### 公開

GXP13

### ローカル開発

GXP14

## ライセンス

MIT ライセンスです。LICENSE ファイルを参照してください。