vimd 0.1.12 → 0.2.0

package/README.md

@@ -2,128 +2,128 @@
 
 🌐 [English](README-en.md) | 日本語
 
-> pandocを使ったリアルタイムMarkdownプレビューツール (view markdown)
+> 書きながら見る。Markdownプレビュー
 
 [![npm version](https://img.shields.io/npm/v/vimd.svg)](https://www.npmjs.com/package/vimd)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-≥18-green.svg)](https://nodejs.org/)
 
-**vimd** は、pandocを使用した高速でシンプルなMarkdownプレビューツールです。複数のテーマに対応したリアルタイムHTMLプレビューを提供します。
+---
 
-## 特徴
+## デモ
 
-- **リアルタイムプレビュー**: ファイル保存時にブラウザが即座に更新 (live-server)
-- **複数テーマ**: 5つの組み込みテーマ (GitHub, Minimal, Dark, Academic, Technical)
-- **pandoc連携**: pandocによる高品質なMarkdown変換
-- **グローバル設定**: プロジェクトディレクトリを汚さない `~/.vimd/config.js`
-- **対話的設定**: `vimd theme` や `vimd config` で簡単に設定変更
-- **クロスプラットフォーム**: macOS, Linux, Windows で動作
+![vimd demo](assets/demo.gif)
 
-## インストール
+---
 
-```bash
-npm install -g vimd
-```
+## テーマ
 
-初回起動時に `vimd theme` で好みのテーマを選択できます。
+<details open>
+<summary><strong>GitHub</strong> (デフォルト)</summary>
 
-### 必要要件
+![GitHub Theme](assets/theme-github.png)
 
-- **Node.js** >= 18.0.0 (ESMサポートが必要)
-- **pandoc** >= 2.0 (別途インストールが必要)
+</details>
 
-pandocのインストール方法:
+<details>
+<summary><strong>Dark</strong></summary>
 
-```bash
-# macOS
-brew install pandoc
+![Dark Theme](assets/theme-dark.png)
 
-# Ubuntu/Debian
-sudo apt install pandoc
+</details>
 
-# Windows
-choco install pandoc
-```
+<details>
+<summary><strong>Academic</strong></summary>
 
-## クイックスタート
+![Academic Theme](assets/theme-academic.png)
 
-```bash
-# ライブプレビューを開始
-vimd dev draft.md
+</details>
 
-# 静的HTMLを生成
-vimd build draft.md
+<details>
+<summary><strong>Minimal</strong></summary>
 
-# テーマを変更
-vimd theme
+![Minimal Theme](assets/theme-minimal.png)
 
-# 設定を編集
-vimd config
-```
+</details>
 
-## コマンド
+<details>
+<summary><strong>Technical</strong></summary>
 
-### `vimd dev <file>`
+![Technical Theme](assets/theme-technical.png)
 
-ホットリロード対応のライブプレビューサーバーを起動します。ブラウザを自動で開き、ファイルの変更を監視します。
+</details>
 
-```bash
-vimd dev draft.md
-vimd dev docs/guide.md --port 3000
-vimd dev article.md --theme dark --no-open
-```
+---
 
-**オプション:**
+## クイックスタート
 
-- `-p, --port <port>`: ポート番号 (デフォルト: 8080)
-- `-t, --theme <theme>`: テーマ名 (グローバル設定を上書き)
-- `--no-open`: ブラウザを自動で開かない
+### 必要要件
 
-### `vimd build <file>`
+- **Node.js** >= 18.0.0
+- **pandoc** >= 2.0（オプション、高品質ビルド時のみ）
 
-静的HTMLファイルを生成します。スタイルが埋め込まれたスタンドアロンHTMLを出力します。
+### インストール
 
 ```bash
-vimd build draft.md
-vimd build docs/guide.md -o dist/guide.html
-vimd build article.md --theme academic
+npm install -g vimd
 ```
 
-**オプション:**
-
-- `-o, --output <path>`: 出力ファイルパス (デフォルト: 同名で拡張子.html)
-- `-t, --theme <theme>`: テーマ名 (グローバル設定を上書き)
+v0.2.0 からは **pandoc なしで利用可能** になりました。
+高品質な出力が必要な場合のみ pandoc をインストールしてください。
 
-### `vimd theme`
+```bash
+# pandocのインストール（オプション）
+brew install pandoc        # macOS
+sudo apt install pandoc    # Ubuntu/Debian
+choco install pandoc       # Windows
+```
 
-対話的にテーマを変更します。5つの組み込みテーマから選択できます。
+### 使い方
 
 ```bash
-vimd theme
-```
+# ライブプレビューを開始（pandoc不要、高速）
+vimd dev draft.md
 
-### `vimd config`
+# 静的HTMLを生成（pandoc使用、高品質）
+vimd build draft.md
 
-対話的に設定を編集します。テーマ、ポート、その他の設定を変更できます。
+# 高速ビルド（pandoc不要）
+vimd build draft.md --fast
 
-```bash
-# 対話的な設定エディタ
-vimd config
+# テーマを変更
+vimd theme
 
-# 現在の設定を表示
-vimd config --list
+# 設定を編集
+vimd config
 ```
 
-## テーマ
+---
+
+## コマンド
 
-vimdには5つの組み込みテーマがあります:
+| コマンド | 説明 |
+|---------|------|
+| `vimd dev <file>` | ライブプレビューサーバーを起動 |
+| `vimd build <file>` | 静的HTMLを生成 |
+| `vimd theme` | テーマを対話的に変更 |
+| `vimd config` | 設定を対話的に編集 |
 
-| テーマ        | 説明                              | 用途                 |
-| ------------- | --------------------------------- | -------------------- |
-| **GitHub**    | GitHub Markdownスタイル (推奨)    | 一般的なドキュメント |
-| **Minimal**   | シンプルな白背景                  | 集中して書きたいとき |
-| **Dark**      | VS Codeインスパイアのダークモード | 夜間の作業           |
-| **Academic**  | 論文スタイルのレイアウト          | 学術論文、研究文書   |
-| **Technical** | APIドキュメントスタイル           | 技術仕様書、API文書  |
+### オプション
+
+```bash
+# dev コマンド
+vimd dev draft.md --port 3000      # ポート指定
+vimd dev draft.md --theme dark     # テーマ指定
+vimd dev draft.md --no-open        # ブラウザを開かない
+vimd dev draft.md --pandoc         # pandocパーサーを使用
+
+# build コマンド
+vimd build draft.md -o output.html # 出力先指定
+vimd build draft.md --fast         # markdown-itで高速ビルド
+vimd build draft.md --theme dark   # テーマ指定
+```
+
+---
 
 ## 設定
 
@@ -133,138 +133,55 @@ vimdには5つの組み込みテーマがあります:
 export default {
   theme: 'github',
   port: 8080,
-  host: 'localhost',
   open: true,
-  pandoc: {
-    standalone: true,
-    toc: false,
-    highlightStyle: 'github',
-  },
-  watch: {
-    ignored: ['node_modules', '.git'],
-  },
+  devParser: 'markdown-it',  // dev用パーサー（デフォルト: markdown-it）
+  buildParser: 'pandoc',     // build用パーサー（デフォルト: pandoc）
 };
 ```
 
-### 設定オプション
-
-- `theme`: デフォルトテーマ名 (文字列)
-- `port`: 開発サーバーのポート (数値、デフォルト: 8080)
-- `host`: 開発サーバーのホスト (文字列、デフォルト: 'localhost')
-- `open`: ブラウザを自動で開く (真偽値、デフォルト: true)
-- `pandoc.standalone`: スタンドアロンHTMLを生成 (真偽値)
-- `pandoc.toc`: 目次を生成 (真偽値)
-- `pandoc.highlightStyle`: コードハイライトスタイル (文字列)
-- `watch.ignored`: ファイル監視で無視するパターン (配列)
-
-## API使用
-
-vimdはNode.jsライブラリとしても使用できます:
-
-```javascript
-import { MarkdownConverter, ConfigLoader, ThemeManager } from 'vimd';
-
-// 設定を読み込む
-const config = await ConfigLoader.loadGlobal();
-
-// コンバーターを作成
-const converter = new MarkdownConverter({
-  theme: 'github',
-  pandocOptions: config.pandoc,
-});
-
-// MarkdownをHTMLに変換
-const html = await converter.convertWithTemplate('draft.md');
-
-// 利用可能なテーマを一覧表示
-const themes = ThemeManager.list();
-console.log(themes); // [{ name: 'github', displayName: 'GitHub' }, ...]
-```
-
-## 開発
-
-```bash
-# リポジトリをクローン
-git clone https://github.com/notokeishou/vimd.git
-cd vimd
-
-# 依存関係をインストール
-npm install
-
-# ビルド
-npm run build
-
-# テストを実行
-npm test
-
-# カバレッジ付きでテスト
-npm run test:coverage
-
-# 開発モード
-npm run dev -- dev test.md
-```
-
-### プロジェクト構造
+### パーサー設定
 
-```
-vimd/
-├── src/
-│   ├── cli/          # CLIコマンド
-│   ├── config/       # 設定管理
-│   ├── core/         # コア機能 (converter, watcher, server)
-│   ├── themes/       # テーマシステム
-│   └── utils/        # ユーティリティ関数
-├── tests/
-│   ├── unit/         # ユニットテスト
-│   └── integration/  # 統合テスト
-├── templates/        # HTMLテンプレート
-└── dist/            # ビルド済みファイル
-```
+| パーサー | 特徴 | 用途 |
+|----------|------|------|
+| `markdown-it` | 高速、pandoc不要 | 開発時のプレビュー |
+| `pandoc` | 高品質、多機能 | 最終出力の生成 |
 
-## トラブルシューティング
+詳細な設定オプションは [docs/api.md](docs/api.md) を参照してください。
 
-### pandocが見つからない
+---
 
-「pandoc not found」エラーが出る場合:
+## Why vimd?
 
-1. パッケージマネージャーでpandocをインストール
-2. インストールを確認: `pandoc --version`
-3. ターミナルを再起動
+| 特徴 | vimd | 他のツール |
+|------|------|-----------|
+| セットアップ | `npm i -g vimd` | 複雑な設定が必要な場合も |
+| 外部依存 | なし（pandocはオプション） | pandoc必須が多い |
+| 変換品質 | markdown-it / pandoc 選択可 | 固定 |
+| テーマ | 5種類組み込み | 別途設定が必要 |
+| 設定ファイル | プロジェクト外 (`~/.vimd/`) | プロジェクト内が多い |
+| ライブリロード | 自動 | 手動リロードが必要な場合も |
 
-### ポートが使用中
+---
 
-ポート8080が既に使用中の場合:
+## ドキュメント
 
-```bash
-vimd dev draft.md --port 3000
-```
+- [開発ガイド](docs/development.md) - 開発環境構築
+- [アーキテクチャ](docs/architecture.md) - プロジェクト構造
+- [APIリファレンス](docs/api.md) - 詳細なオプション
+- [テスト](docs/testing.md) - テスト構成
+- [トラブルシューティング](docs/troubleshooting.md) - よくある問題
 
-または `~/.vimd/config.js` でデフォルトポートを変更してください。
+---
 
-### テーマが適用されない
+## リンク
 
-以下を確認してください:
+- [CONTRIBUTING.md](CONTRIBUTING.md) - コントリビューションガイド
+- [CHANGELOG.md](CHANGELOG.md) - 変更履歴
+- [GitHub](https://github.com/notokeishou/vimd)
+- [npm](https://www.npmjs.com/package/vimd)
 
-1. 利用可能なテーマを確認: `vimd theme`
-2. 設定を確認: `vimd config --list`
-3. ソースからの場合は再ビルド: `npm run build`
+---
 
 ## ライセンス
 
 MIT © notokeishou
-
-## コントリビューション
-
-コントリビューションを歓迎します! プルリクエストの提出方法については [CONTRIBUTING.md](CONTRIBUTING.md) をお読みください。
-
-## 変更履歴
-
-リリース履歴は [CHANGELOG.md](CHANGELOG.md) を参照してください。
-
-## リンク
-
-- [GitHubリポジトリ](https://github.com/notokeishou/vimd)
-- [npmパッケージ](https://www.npmjs.com/package/vimd)
-- [Issue Tracker](https://github.com/notokeishou/vimd/issues)
-
----

package/dist/cli/commands/build.d.ts

@@ -1,6 +1,7 @@
 interface BuildOptions {
     output?: string;
     theme?: string;
+    fast?: boolean;
 }
 export declare function buildCommand(filePath: string, options: BuildOptions): Promise<void>;
 export {};

package/dist/cli/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CA0Df"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AASA,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/dist/cli/commands/build.js

@@ -2,6 +2,7 @@
 import { ConfigLoader } from '../../config/loader.js';
 import { MarkdownConverter } from '../../core/converter.js';
 import { PandocDetector } from '../../core/pandoc-detector.js';
+import { ParserFactory } from '../../core/parser/index.js';
 import { Logger } from '../../utils/logger.js';
 import * as path from 'path';
 import fs from 'fs-extra';
@@ -15,30 +16,38 @@ export async function buildCommand(filePath, options) {
             config.theme = options.theme;
         }
         Logger.info(`Theme: ${config.theme}`);
-        // 2. Check pandoc installation
-        PandocDetector.ensureInstalled();
-        // 3. Check file exists
+        // 2. Determine parser type
+        const parserType = options.fast ? 'markdown-it' : config.buildParser;
+        Logger.info(`Parser: ${parserType}`);
+        // 3. Check pandoc installation only if pandoc parser is selected
+        if (parserType === 'pandoc') {
+            PandocDetector.ensureInstalled();
+        }
+        // 4. Check file exists
         const absolutePath = path.resolve(filePath);
         if (!(await fs.pathExists(absolutePath))) {
             Logger.error(`File not found: ${filePath}`);
             process.exit(1);
         }
-        // 4. Determine output path
+        // 5. Determine output path
         const outputPath = options.output
             ? path.resolve(options.output)
             : path.join(path.dirname(absolutePath), path.basename(filePath, path.extname(filePath)) + '.html');
         Logger.info(`Output: ${outputPath}`);
-        // 5. Prepare converter
+        // 6. Prepare converter with selected parser
+        const pandocOptions = {
+            ...config.pandoc,
+            standalone: true, // build always uses standalone
+        };
+        const parser = ParserFactory.create(parserType, pandocOptions);
         const converter = new MarkdownConverter({
             theme: config.theme,
-            pandocOptions: {
-                ...config.pandoc,
-                standalone: true, // build always uses standalone
-            },
+            pandocOptions: pandocOptions,
             customCSS: config.css,
             template: config.template || undefined,
         });
-        // 6. Execute conversion
+        converter.setParser(parser);
+        // 7. Execute conversion
         Logger.info('Converting...');
         const html = await converter.convertWithTemplate(absolutePath);
         await converter.writeHTML(html, outputPath);

package/dist/cli/commands/dev.d.ts

@@ -2,6 +2,7 @@ interface DevOptions {
     port?: string;
     theme?: string;
     open?: boolean;
+    pandoc?: boolean;
 }
 export declare function devCommand(filePath: string, options: DevOptions): Promise<void>;
 export {};

package/dist/cli/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAYA,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA+If"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAaA,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAuJf"}

package/dist/cli/commands/dev.js

@@ -4,6 +4,7 @@ import { FileWatcher } from '../../core/watcher.js';
 import { MarkdownConverter } from '../../core/converter.js';
 import { LiveServer } from '../../core/server.js';
 import { PandocDetector } from '../../core/pandoc-detector.js';
+import { ParserFactory } from '../../core/parser/index.js';
 import { Logger } from '../../utils/logger.js';
 import { ProcessManager } from '../../utils/process-manager.js';
 import { SessionManager } from '../../utils/session-manager.js';
@@ -47,32 +48,39 @@ export async function devCommand(filePath, options) {
         }
         Logger.info(`Theme: ${config.theme}`);
         Logger.info(`Port: ${port}`);
-        // 5. Check pandoc installation
-        PandocDetector.ensureInstalled();
-        // 6. Check file exists
+        // 5. Determine parser type
+        const parserType = options.pandoc ? 'pandoc' : config.devParser;
+        Logger.info(`Parser: ${parserType}`);
+        // 6. Check pandoc installation only if pandoc parser is selected
+        if (parserType === 'pandoc') {
+            PandocDetector.ensureInstalled();
+        }
+        // 7. Check file exists
         const absolutePath = path.resolve(filePath);
         if (!(await fs.pathExists(absolutePath))) {
             Logger.error(`File not found: ${filePath}`);
             process.exit(1);
         }
-        // 7. Prepare output HTML in source directory
+        // 8. Prepare output HTML in source directory
         const sourceDir = path.dirname(absolutePath);
         const basename = path.basename(filePath, path.extname(filePath));
         const htmlFileName = `vimd-preview-${basename}.html`;
         const htmlPath = path.join(sourceDir, htmlFileName);
-        // 8. Prepare converter
+        // 9. Prepare converter with selected parser
+        const parser = ParserFactory.create(parserType, config.pandoc);
         const converter = new MarkdownConverter({
             theme: config.theme,
             pandocOptions: config.pandoc,
             customCSS: config.css,
             template: config.template,
         });
-        // 9. Initial conversion
+        converter.setParser(parser);
+        // 10. Initial conversion
         Logger.info('Converting markdown...');
         const html = await converter.convertWithTemplate(absolutePath);
         await converter.writeHTML(html, htmlPath);
         Logger.success('Conversion complete');
-        // 10. Start live server from source directory
+        // 11. Start live server from source directory
         const server = new LiveServer({
             port: port,
             host: config.host,
@@ -80,7 +88,7 @@ export async function devCommand(filePath, options) {
             root: sourceDir,
         });
         await server.start(htmlPath);
-        // 11. Save session
+        // 12. Save session
         await SessionManager.saveSession({
             pid: process.pid,
             port: port,
@@ -90,7 +98,7 @@ export async function devCommand(filePath, options) {
         });
         Logger.info(`Watching: ${filePath}`);
         Logger.info('Press Ctrl+C to stop');
-        // 12. Start file watching
+        // 13. Start file watching
         const watcher = new FileWatcher(absolutePath, config.watch);
         watcher.onChange(async (changedPath) => {
             Logger.info('File changed, reconverting...');
@@ -107,7 +115,7 @@ export async function devCommand(filePath, options) {
             }
         });
         watcher.start();
-        // 13. Register cleanup - remove generated HTML file and session
+        // 14. Register cleanup - remove generated HTML file and session
         ProcessManager.onExit(async () => {
             Logger.info('Shutting down...');
             await watcher.stop();

package/dist/cli/index.js

@@ -19,6 +19,7 @@ program
     .option('-p, --port <port>', 'Port number', '8080')
     .option('-t, --theme <theme>', 'Theme name')
     .option('--no-open', 'Do not open browser automatically')
+    .option('--pandoc', 'Use pandoc parser instead of markdown-it')
     .action(devCommand);
 // vimd build <file>
 program
@@ -26,6 +27,7 @@ program
     .description('Build static HTML file')
     .option('-o, --output <path>', 'Output file path')
     .option('-t, --theme <theme>', 'Theme name')
+    .option('--fast', 'Use markdown-it parser for faster build')
     .action(buildCommand);
 // vimd theme
 program

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,cAAc,EAAE,UAkB5B,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,cAAc,EAAE,UAoB5B,CAAC"}

package/dist/config/defaults.js

@@ -16,4 +16,6 @@ export const DEFAULT_CONFIG = {
         inlineCSS: false,
         standalone: true,
     },
+    devParser: 'markdown-it',
+    buildParser: 'pandoc',
 };

package/dist/config/types.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Available parser types.
+ * Duplicated here to avoid circular dependency with core/parser/types.ts
+ */
+export type ConfigParserType = 'markdown-it' | 'pandoc';
 export interface VimdConfig {
     theme: 'github' | 'minimal' | 'dark' | 'academic' | 'technical';
     port: number;
@@ -8,6 +13,8 @@ export interface VimdConfig {
     pandoc: PandocConfig;
     watch: WatchConfig;
     build?: BuildConfig;
+    devParser: ConfigParserType;
+    buildParser: ConfigParserType;
 }
 export interface PandocConfig {
     standalone: boolean;

package/dist/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAEpE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,WAAW,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAEpE"}

package/dist/core/converter.d.ts

@@ -1,8 +1,26 @@
 import { ConverterConfig } from '../config/types.js';
+import { Parser } from './parser/index.js';
 export declare class MarkdownConverter {
     private config;
+    private parser;
     constructor(config: ConverterConfig);
+    /**
+     * Set the parser to use for conversion.
+     * If not set, falls back to legacy pandoc conversion.
+     * @param parser - The parser instance to use
+     */
+    setParser(parser: Parser): void;
+    /**
+     * Get the currently set parser.
+     * @returns The parser instance or null if not set
+     */
+    getParser(): Parser | null;
     convert(markdownPath: string): Promise<string>;
+    /**
+     * Legacy pandoc conversion method.
+     * Used when no parser is explicitly set (backward compatibility).
+     */
+    private convertWithPandocLegacy;
     convertWithTemplate(markdownPath: string): Promise<string>;
     writeHTML(html: string, outputPath: string): Promise<void>;
     private buildPandocArgs;

package/dist/core/converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/core/converter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AASrD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB9C,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,OAAO,CAAC,eAAe;CA+BxB"}
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/core/converter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQ3C,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,MAAM,CAAuB;gBAEjB,MAAM,EAAE,eAAe;IAE3C;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWpD;;;OAGG;YACW,uBAAuB;IAiB/B,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,OAAO,CAAC,eAAe;CA+BxB"}

package/dist/core/converter.js

@@ -9,8 +9,37 @@ const __dirname = path.dirname(__filename);
 export class MarkdownConverter {
     constructor(config) {
         this.config = config;
+        this.parser = null;
+    }
+    /**
+     * Set the parser to use for conversion.
+     * If not set, falls back to legacy pandoc conversion.
+     * @param parser - The parser instance to use
+     */
+    setParser(parser) {
+        this.parser = parser;
+    }
+    /**
+     * Get the currently set parser.
+     * @returns The parser instance or null if not set
+     */
+    getParser() {
+        return this.parser;
     }
     async convert(markdownPath) {
+        // If a parser is set, use it
+        if (this.parser) {
+            const content = await fs.readFile(markdownPath, 'utf-8');
+            return this.parser.parse(content);
+        }
+        // Legacy: use direct pandoc execution for backward compatibility
+        return this.convertWithPandocLegacy(markdownPath);
+    }
+    /**
+     * Legacy pandoc conversion method.
+     * Used when no parser is explicitly set (backward compatibility).
+     */
+    async convertWithPandocLegacy(markdownPath) {
         const pandocArgs = this.buildPandocArgs();
         const command = `pandoc ${pandocArgs.join(' ')} "${markdownPath}"`;
         try {
@@ -68,7 +97,7 @@ export class MarkdownConverter {
             }
         }
         if (this.config.pandocOptions.highlightStyle) {
-            args.push(`--highlight-style=${this.config.pandocOptions.highlightStyle}`);
+            args.push(`--syntax-highlighting=${this.config.pandocOptions.highlightStyle}`);
         }
         // Metadata
         if (this.config.pandocOptions.metadata) {

package/dist/core/pandoc-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pandoc-detector.d.ts","sourceRoot":"","sources":["../../src/core/pandoc-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,qBAAa,cAAc;IACzB,MAAM,CAAC,KAAK,IAAI,OAAO;IASvB,MAAM,CAAC,QAAQ,IAAI,MAAM;IAczB,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA4CzC,MAAM,CAAC,eAAe,IAAI,IAAI;CAQ/B"}
+{"version":3,"file":"pandoc-detector.d.ts","sourceRoot":"","sources":["../../src/core/pandoc-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,qBAAa,cAAc;IACzB,MAAM,CAAC,KAAK,IAAI,OAAO;IASvB,MAAM,CAAC,QAAQ,IAAI,MAAM;IAczB,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiDzC,MAAM,CAAC,eAAe,IAAI,IAAI;CAQ/B"}

package/dist/core/pandoc-detector.js

@@ -26,8 +26,13 @@ export class PandocDetector {
     static showInstallGuide(os) {
         console.error('⚠️  pandoc not found');
         console.error('');
-        console.error('vimd requires pandoc to convert Markdown to HTML.');
-        console.error('Please install pandoc manually:');
+        console.error('pandoc is required for the selected parser mode.');
+        console.error('');
+        console.error('Option 1: Use markdown-it mode (no pandoc needed)');
+        console.error('  vimd dev document.md       (default, fast preview)');
+        console.error('  vimd build document.md --fast');
+        console.error('');
+        console.error('Option 2: Install pandoc for high-quality output');
         console.error('');
         switch (os) {
             case 'macos':

package/dist/core/parser/index.d.ts

@@ -0,0 +1,5 @@
+export type { Parser, ParserType } from './types.js';
+export { MarkdownItParser } from './markdown-it-parser.js';
+export { PandocParser } from './pandoc-parser.js';
+export { ParserFactory } from './parser-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/parser/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/parser/index.js

@@ -0,0 +1,4 @@
+// src/core/parser/index.ts
+export { MarkdownItParser } from './markdown-it-parser.js';
+export { PandocParser } from './pandoc-parser.js';
+export { ParserFactory } from './parser-factory.js';

package/dist/core/parser/markdown-it-parser.d.ts

@@ -0,0 +1,23 @@
+import { Parser } from './types.js';
+/**
+ * Markdown parser using markdown-it library.
+ * Provides fast markdown to HTML conversion with GFM support.
+ */
+export declare class MarkdownItParser implements Parser {
+    readonly name = "markdown-it";
+    private md;
+    constructor();
+    /**
+     * Convert markdown to HTML.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    parse(markdown: string): Promise<string>;
+    /**
+     * Check if the parser is available.
+     * markdown-it is always available as it's an npm package.
+     * @returns Always returns true
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=markdown-it-parser.d.ts.map

package/dist/core/parser/markdown-it-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-it-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/markdown-it-parser.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,EAAE,CAAa;;IAwBvB;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/core/parser/markdown-it-parser.js

@@ -0,0 +1,49 @@
+// src/core/parser/markdown-it-parser.ts
+import MarkdownIt from 'markdown-it';
+import hljs from 'highlight.js';
+import strikethrough from 'markdown-it-strikethrough-alt';
+import taskLists from 'markdown-it-task-lists';
+/**
+ * Markdown parser using markdown-it library.
+ * Provides fast markdown to HTML conversion with GFM support.
+ */
+export class MarkdownItParser {
+    constructor() {
+        this.name = 'markdown-it';
+        this.md = new MarkdownIt({
+            html: true,
+            linkify: true,
+            typographer: true,
+            highlight: (str, lang) => {
+                if (lang && hljs.getLanguage(lang)) {
+                    try {
+                        return hljs.highlight(str, { language: lang }).value;
+                    }
+                    catch {
+                        // Ignore highlight errors
+                    }
+                }
+                return ''; // Use external default escaping
+            },
+        });
+        // Enable GFM plugins
+        this.md.use(strikethrough); // ~~strikethrough~~
+        this.md.use(taskLists); // - [ ] task list
+    }
+    /**
+     * Convert markdown to HTML.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    async parse(markdown) {
+        return this.md.render(markdown);
+    }
+    /**
+     * Check if the parser is available.
+     * markdown-it is always available as it's an npm package.
+     * @returns Always returns true
+     */
+    async isAvailable() {
+        return true;
+    }
+}

package/dist/core/parser/pandoc-parser.d.ts

@@ -0,0 +1,27 @@
+import { Parser } from './types.js';
+import { PandocConfig } from '../../config/types.js';
+/**
+ * Markdown parser using pandoc.
+ * Provides high-quality markdown to HTML conversion with extensive features.
+ */
+export declare class PandocParser implements Parser {
+    readonly name = "pandoc";
+    private config;
+    constructor(config?: Partial<PandocConfig>);
+    /**
+     * Convert markdown to HTML using pandoc.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    parse(markdown: string): Promise<string>;
+    /**
+     * Check if pandoc is available.
+     * @returns true if pandoc is installed and accessible
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build pandoc command arguments from config.
+     */
+    private buildPandocArgs;
+}
+//# sourceMappingURL=pandoc-parser.d.ts.map

package/dist/core/parser/pandoc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pandoc-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/pandoc-parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAYrD;;;GAGG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB9C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;OAEG;IACH,OAAO,CAAC,eAAe;CA+BxB"}

package/dist/core/parser/pandoc-parser.js

@@ -0,0 +1,83 @@
+// src/core/parser/pandoc-parser.ts
+import { execSync } from 'child_process';
+/**
+ * Default pandoc configuration for high-quality HTML output.
+ */
+const DEFAULT_PANDOC_CONFIG = {
+    standalone: false,
+    toc: false,
+    tocDepth: 3,
+    highlightStyle: 'pygments',
+};
+/**
+ * Markdown parser using pandoc.
+ * Provides high-quality markdown to HTML conversion with extensive features.
+ */
+export class PandocParser {
+    constructor(config = {}) {
+        this.name = 'pandoc';
+        this.config = { ...DEFAULT_PANDOC_CONFIG, ...config };
+    }
+    /**
+     * Convert markdown to HTML using pandoc.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    async parse(markdown) {
+        const pandocArgs = this.buildPandocArgs();
+        const command = `pandoc ${pandocArgs.join(' ')}`;
+        try {
+            const html = execSync(command, {
+                encoding: 'utf-8',
+                input: markdown,
+                maxBuffer: 10 * 1024 * 1024, // 10MB
+            });
+            return html;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to convert markdown with pandoc: ${errorMessage}`);
+        }
+    }
+    /**
+     * Check if pandoc is available.
+     * @returns true if pandoc is installed and accessible
+     */
+    async isAvailable() {
+        try {
+            execSync('pandoc --version', { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Build pandoc command arguments from config.
+     */
+    buildPandocArgs() {
+        const args = [];
+        // Basic options
+        args.push('--from=markdown');
+        args.push('--to=html');
+        if (this.config.standalone) {
+            args.push('--standalone');
+        }
+        if (this.config.toc) {
+            args.push('--toc');
+            if (this.config.tocDepth) {
+                args.push(`--toc-depth=${this.config.tocDepth}`);
+            }
+        }
+        if (this.config.highlightStyle) {
+            args.push(`--syntax-highlighting=${this.config.highlightStyle}`);
+        }
+        // Metadata
+        if (this.config.metadata) {
+            Object.entries(this.config.metadata).forEach(([key, value]) => {
+                args.push(`--metadata=${key}:"${value}"`);
+            });
+        }
+        return args;
+    }
+}

package/dist/core/parser/parser-factory.d.ts

@@ -0,0 +1,36 @@
+import { Parser, ParserType } from './types.js';
+import { PandocConfig } from '../../config/types.js';
+/**
+ * Factory for creating parser instances.
+ * Provides methods to create parsers by type and with fallback support.
+ */
+export declare class ParserFactory {
+    /**
+     * Create a parser instance by type.
+     * @param type - The type of parser to create
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance
+     * @throws Error if the parser type is unknown
+     */
+    static create(type: ParserType, pandocConfig?: Partial<PandocConfig>): Parser;
+    /**
+     * Create a parser with fallback support.
+     * If the preferred parser is not available, falls back to markdown-it.
+     * @param preferred - The preferred parser type
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance that is guaranteed to be available
+     * @throws Error if pandoc is preferred but not installed (no silent fallback)
+     */
+    static createWithFallback(preferred: ParserType, pandocConfig?: Partial<PandocConfig>): Promise<Parser>;
+    /**
+     * Get the default parser type for dev mode.
+     * @returns 'markdown-it' as the default for fast preview
+     */
+    static getDefaultDevParser(): ParserType;
+    /**
+     * Get the default parser type for build mode.
+     * @returns 'pandoc' as the default for high-quality output
+     */
+    static getDefaultBuildParser(): ParserType;
+}
+//# sourceMappingURL=parser-factory.d.ts.map

package/dist/core/parser/parser-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-factory.d.ts","sourceRoot":"","sources":["../../../src/core/parser/parser-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM;IAa7E;;;;;;;OAOG;WACU,kBAAkB,CAC7B,SAAS,EAAE,UAAU,EACrB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC;IAmBlB;;;OAGG;IACH,MAAM,CAAC,mBAAmB,IAAI,UAAU;IAIxC;;;OAGG;IACH,MAAM,CAAC,qBAAqB,IAAI,UAAU;CAG3C"}

package/dist/core/parser/parser-factory.js

@@ -0,0 +1,63 @@
+// src/core/parser/parser-factory.ts
+import { MarkdownItParser } from './markdown-it-parser.js';
+import { PandocParser } from './pandoc-parser.js';
+/**
+ * Factory for creating parser instances.
+ * Provides methods to create parsers by type and with fallback support.
+ */
+export class ParserFactory {
+    /**
+     * Create a parser instance by type.
+     * @param type - The type of parser to create
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance
+     * @throws Error if the parser type is unknown
+     */
+    static create(type, pandocConfig) {
+        switch (type) {
+            case 'markdown-it':
+                return new MarkdownItParser();
+            case 'pandoc':
+                return new PandocParser(pandocConfig);
+            default:
+                // TypeScript exhaustive check
+                const _exhaustive = type;
+                throw new Error(`Unknown parser type: ${_exhaustive}`);
+        }
+    }
+    /**
+     * Create a parser with fallback support.
+     * If the preferred parser is not available, falls back to markdown-it.
+     * @param preferred - The preferred parser type
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance that is guaranteed to be available
+     * @throws Error if pandoc is preferred but not installed (no silent fallback)
+     */
+    static async createWithFallback(preferred, pandocConfig) {
+        const parser = this.create(preferred, pandocConfig);
+        if (await parser.isAvailable()) {
+            return parser;
+        }
+        // If pandoc was requested but not available, throw an error
+        // (we don't silently fall back to markdown-it for explicit pandoc requests)
+        if (preferred === 'pandoc') {
+            throw new Error('pandoc is not installed. Please install pandoc or use markdown-it parser.');
+        }
+        // For markdown-it, it's always available
+        return parser;
+    }
+    /**
+     * Get the default parser type for dev mode.
+     * @returns 'markdown-it' as the default for fast preview
+     */
+    static getDefaultDevParser() {
+        return 'markdown-it';
+    }
+    /**
+     * Get the default parser type for build mode.
+     * @returns 'pandoc' as the default for high-quality output
+     */
+    static getDefaultBuildParser() {
+        return 'pandoc';
+    }
+}

package/dist/core/parser/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parser interface for markdown to HTML conversion.
+ * Both markdown-it and pandoc parsers implement this interface.
+ */
+export interface Parser {
+    /**
+     * Convert markdown content to HTML.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    parse(markdown: string): Promise<string>;
+    /**
+     * Check if the parser is available for use.
+     * @returns true if the parser can be used
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * The name of the parser.
+     */
+    readonly name: string;
+}
+/**
+ * Available parser types.
+ */
+export type ParserType = 'markdown-it' | 'pandoc';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/parser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/parser/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzC;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC"}

package/dist/core/parser/types.js

@@ -0,0 +1,2 @@
+// src/core/parser/types.ts
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimd",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Real-time Markdown preview tool with pandoc (view markdown)",
   "type": "module",
   "keywords": [
@@ -51,6 +51,7 @@
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
+    "@types/markdown-it": "^14.1.2",
     "@types/node": "^20.19.25",
     "@typescript-eslint/eslint-plugin": "^6.21.0",
     "@typescript-eslint/parser": "^6.21.0",
@@ -67,8 +68,12 @@
     "commander": "^12.1.0",
     "fs-extra": "^11.3.2",
     "github-markdown-css": "^5.8.1",
+    "highlight.js": "^11.11.1",
     "inquirer": "^9.3.8",
     "live-server": "^1.2.2",
+    "markdown-it": "^14.1.0",
+    "markdown-it-strikethrough-alt": "^1.0.0",
+    "markdown-it-task-lists": "^2.1.1",
     "open": "^9.1.0"
   }
 }