open-index/open-npm huggingface dataset:
npm package: @j2masamitu/md2pdf-ja
Description: Convert Japanese Markdown files to beautiful PDFs with math equations, alerts, and footnotes support
Author: Your Name
Latest version: 1.1.4

# md2pdf-ja

日本語のMarkdownファイルを美しいPDFファイルに変換するツールです。日本語フォント、禁則処理、適切な行間設定など、日本語文書に最適化されています。

## 特徴

- 日本語フォント（Noto Sans JP / Noto Serif JP）に対応
- GitHub Flavored Markdown (GFM) サポート
- **数式のレンダリング（KaTeX）** - インライン数式 `$...$` とブロック数式 `$$...$$` に対応
- **GitHubアラート** - `[!NOTE]`, `[!WARNING]`, `[!IMPORTANT]` などの警告ブロック
- **脚注機能** - 学術文書やレポート向けの脚注サポート
- **見出しIDの自動生成** - GitHubスタイルの見出しID
- **目次の自動生成** - `--toc` オプションで目次を生成
- **ローカル画像サポート** - 絶対パス・相対パスの画像を自動変換（Windows/Mac/Linux対応）
- シンタックスハイライト対応
- 複数のテーマ（デフォルト、学術、ビジネス）
- カスタムCSSサポート
- 用紙サイズ指定（A4, A5, B5, Letter）

## インストール

```bash
npm install -g @j2masamitu/md2pdf-ja
```

### 開発環境セットアップ

```bash
git clone https://github.com/j2masamitu/md2pdf-ja
cd md2pdf-ja
npm install
npm run build
```

### ローカルでグローバルインストール（テスト用）

```bash
npm run build
npm link
```

## 使い方

### 基本的な使い方（グローバルインストール後）

```bash
md2pdf-ja sample.md
```

### オプション

```bash
# 出力ファイルを指定
md2pdf-ja input.md -o output.pdf

# タイトルと著者を指定
md2pdf-ja input.md -t "ドキュメントタイトル" -a "著者名"

# テーマを指定
md2pdf-ja input.md --theme academic

# 用紙サイズを指定
md2pdf-ja input.md --format B5

# カスタムCSSを使用
md2pdf-ja input.md --css custom.css
```

### 開発環境での使い方

```bash
# 開発モード
npm run dev sample.md

# または、ビルド後
node dist/cli.js sample.md
```

### 利用可能なオプション

- `-o, --output <path>`: 出力PDFファイルパス
- `-t, --title <title>`: ドキュメントのタイトル
- `-a, --author <author>`: 著者名
- `--theme <theme>`: テーマ (default, academic, business)
- `--format <format>`: 用紙サイズ (A4, A5, B5, Letter)
- `--css <path>`: カスタムCSSファイルのパス
- `--page-numbers`: ページ番号を追加
- `--toc`: 目次を生成

## 新機能の使い方

### 数式（Math Equations）

インライン数式は `$...$` で、ブロック数式は `$$...$$` で囲みます。

```markdown
インライン数式: $E = mc^2$

ブロック数式:
$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$
```

### GitHubアラート（Alerts）

5種類のアラートタイプが利用できます。

```markdown
> [!NOTE]
> 重要な情報を示すノート

> [!TIP]
> 便利なヒントやアドバイス

> [!IMPORTANT]
> 非常に重要な情報

> [!WARNING]
> 注意が必要な警告

> [!CAUTION]
> 危険性についての注意喚起
```

### 脚注（Footnotes）

```markdown
この文章には脚注があります[^1]。

[^1]: これは脚注の内容です。
```

### 目次の生成

`--toc` オプションを使用すると、見出しから自動的に目次を生成します。

```bash
md2pdf-ja document.md --toc -o output.pdf
```

### 画像の埋め込み

ローカル画像は自動的に`file://`プロトコルに変換されます。

```markdown
<!-- 相対パス -->
![図1](./images/diagram.png)

<!-- 絶対パス（Windows） -->
![図2](C:\Users\user\images\chart.png)

<!-- 絶対パス（Mac/Linux） -->
![図3](/home/user/images/photo.jpg)

<!-- URL -->
![図4](https://example.com/image.png)
```

すべてのパス形式に対応しています。

## テーマ

### デフォルト
標準的な読みやすいスタイル

### academic
学術論文向けのフォーマット

### business
ビジネス文書向けのフォーマット

## 技術スタック

- TypeScript
- Puppeteer (PDF生成)
- marked (Markdown解析)
- Commander (CLI)
- Noto Sans/Serif CJK JP (日本語フォント)

## ライセンス

MIT
npm package: @j2masamitu/md2pdf-ja-mcp
Description: MCP server for md2pdf-ja - Convert Japanese Markdown to PDF
Author: Your Name
Latest version: 1.0.1

# md2pdf-ja-mcp

[md2pdf-ja](https://github.com/j2masamitu/md2pdf-ja) 用の MCP (Model Context Protocol) サーバー - Claude Code から直接、日本語の Markdown ファイルを美しい PDF に変換します。

## 機能

- 🚀 Claude Code から Markdown を PDF に変換
- 🇯🇵 日本語文書に最適化
- 🎨 複数のテーマ（default、academic、business）
- 📄 カスタムページフォーマット（A4、A5、B5、Letter）
- 🎯 カスタム CSS サポート
- ⚡ 高速で効率的な変換

## 前提条件

この MCP サーバーを使用する前に、[md2pdf-ja](https://github.com/j2masamitu/md2pdf-ja) をインストールする必要があります：

```bash
npm install -g @j2masamitu/md2pdf-ja
```

## インストール

### オプション 1: npm（推奨）

```bash
npm install -g @j2masamitu/md2pdf-ja-mcp
```

### オプション 2: ソースから

```bash
git clone https://github.com/j2masamitu/md2pdf-ja-mcp
cd md2pdf-ja-mcp
npm install
npm run build
npm link
```

## 設定

### Claude Code の設定

```bash
claude mcp add md2pdf-ja-mcp md2pdf-ja-mcp --scope user
```

## 利用可能なツール

### convert_markdown_to_pdf

日本語の Markdown ファイルを美しい PDF に変換します。

**パラメータ：**

- `input`（必須）：入力 Markdown ファイルへのパス
- `output`（オプション）：出力 PDF ファイルへのパス
- `title`（オプション）：文書のタイトル - **明示的に要求された場合のみ使用**
- `author`（オプション）：文書の著者 - **明示的に要求された場合のみ使用**
- `theme`（オプション）：テーマ（`default`、`academic`、`business`）- **明示的に要求された場合のみ使用**
- `format`（オプション）：ページフォーマット（`A4`、`A5`、`B5`、`Letter`）- **明示的に要求された場合のみ使用**
- `css`（オプション）：カスタム CSS ファイルへのパス - **明示的に要求された場合のみ使用**

**重要：** デフォルトでは、`input`（およびオプションで `output`）パラメータのみを使用する必要があります。他のパラメータは、ユーザーが明示的に要求した場合にのみ含める必要があります。これにより、PDF 内のタイトルの重複や不要なメタデータを防ぎます。

**Claude Code での使用例：**

```
document.md を PDF に変換して
```

```
document.md を academic テーマで PDF に変換して
```

Claude Code は、リクエストに基づいて適切なパラメータを使用して MCP ツールを自動的に使用します。

## 使用例

### 基本的な変換

```
my-document.md を PDF に変換して
```

### オプション付き

```
report.md を以下のオプションで PDF に変換して：
- タイトル: 「2024年度年次報告書」
- 著者: 「山田太郎」
- テーマ: academic
- フォーマット: A4
```

### カスタム CSS 使用

```
presentation.md を custom.css を使用してスタイリングして PDF に変換して
```

## 開発

```bash
# 依存関係のインストール
npm install

# ビルド
npm run build

# ウォッチモード
npm run watch
```

## 動作の仕組み

この MCP サーバーは：
1. Claude Code からリクエストを受信
2. 入力パラメータの検証
3. 適切なオプションで md2pdf-ja CLI を実行
4. 変換結果を Claude Code に返す

## トラブルシューティング

### 「md2pdf-ja: command not found」

md2pdf-ja がグローバルにインストールされていることを確認してください：

```bash
npm install -g @j2masamitu/md2pdf-ja
md2pdf-ja --version
```

### Claude Code に MCP サーバーが表示されない

1. 設定ファイルのパスが正しいことを確認
2. JSON 構文が有効であることを確認
3. Claude Code を完全に再起動
4. Claude Code のログでエラーを確認

### パーミッションエラー

dist/index.js ファイルが実行可能であることを確認してください：

```bash
chmod +x dist/index.js
```

## ライセンス

MIT

## 関連プロジェクト

- [md2pdf-ja](https://github.com/j2masamitu/md2pdf-ja) - コアコンバータツール
- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP 仕様
npm package: @j2only/ionic-disable-swipe-back
Description: Vue 3 directive for Ionic framework, disables switching to previous route if the user makes a swipe on iOS devices
Author: Anton Zolotov
Latest version: 1.0.8

# @j2only/ionic-disable-swipe-back

## Important Notice

**@j2only/ionic-disable-swipe-back is not compatible with Ionic Vue 8.x**

**Reason**: Starting from Ionic Vue 8, the internal gesture system and routing mechanisms have been significantly refactored. The createGesture API is no longer exposed in @ionic/vue and custom gestures can no longer interact with or override the swipe-back navigation gesture. As a result, this package no longer works as intended.

**Why there is no workaround**: Ionic Vue 8 does not provide any official public API for disabling the swipe-back gesture on specific pages or globally. All gesture controls are now managed internally by the framework. Any attempts to disable swipe-back require hacking internal, undocumented properties, which are unstable and may break at any time. Therefore, at this time, there is no reliable or officially supported way to disable the swipe-back gesture in Ionic Vue 8.

**Recommendation**: If you rely on disabling swipe-back, please do not upgrade to Ionic Vue 8, or consider switching to Ionic Angular, where this functionality is still officially supported.

---

![npm publish](https://github.com/j2only/ionic-disable-swipe-back/actions/workflows/npm.yml/badge.svg) [![npm](https://img.shields.io/npm/v/@j2only/ionic-disable-swipe-back.svg)](https://www.npmjs.com/package/@j2only/ionic-disable-swipe-back) ![npm bundle size (scoped)](https://img.shields.io/bundlephobia/minzip/%40j2only/ionic-disable-swipe-back) ![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/j2only/ionic-disable-swipe-back) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/) [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/j2only/ionic-disable-swipe-back/issues) ![GitHub](https://img.shields.io/github/license/j2only/ionic-disable-swipe-back)

## Installation

Install this component via package manager:

```bash
yarn add @j2only/ionic-disable-swipe-back
```

## Usage

Import the component in your app. Example of the main.ts file in your ionic vue project:

```typescript
<script setup lang="ts">
    import App from "./App.vue" import {DisableSwipeBackDirective} from
    "@j2only/ionic-disable-swipe-back" const app = createApp(App)
    .directive("disable-swipe-back", DisableSwipeBackDirective)
    app.mount("#app")
</script>
```

In vue template include directive in ion-page

```vue
<template>
    <ion-page v-disable-swipe-back> ... </ion-page>
</template>
```

## Licensing

MIT License
Forked from [@Sitronik/v-disable-swipe-back](https://github.com/Sitronik/v-disable-swipe-back), Sitronik, [MIT License](LICENSE)