Markdown Preview Enhanced で PDF を生成しようとすると、
“princexml is required to be installed” とだけ表示されて処理が止まってしまうことがあります。
私の環境（Windows 11 / VS Code）でも 2024年6月にまったく同じエラーが発生しましたが、
結論として「PrinceXML を手動インストールするだけ」で問題は解消しました。
この記事では、公式ドキュメントでは分かりづらい
「どこからダウンロードするのか」「実際に出る画面はどういうものか」
を実体験ベースで整理して解説します。
忙しい人用
↓これインストールしたらOKです（たぶん、多くの場合）。
https://www.princexml.com/download/15
↑ダウンロードする
.NET Framework 3.5のインストールをさせられるかもしれないですが、OKを押していけばいいです。
機種によっては5分近くかかるかもしれないです。
以下、詳しい解説
Visual Studio CodeのMarkdown Preview Enhanced拡張機能を使って、PDFを出力しようとしたところ、「”princexml” is required to be installed.」が出てしまいました。調べてもトラブルシュートが以下の記事しかでてこなかったので、私のトラブルシュートも記しておきます。
Cf. 「Markdown Preview Enhancedでprinceを利用してPDF化するときに日本語が文字化けする」https://qiita.com/rrr/items/9b938f7b58d609f32e62
環境
- Windows 11
- Visual Studio Code
原因
Markdown Preview Enhanced で PDF を生成する際、
内部的に PrinceXML を使用する設定になっている場合、
PC に PrinceXML 本体がインストールされていないとこのエラーが出ます。
VS Code や拡張機能側の不具合ではなく、
単純に PrinceXML が未インストールなことが原因です。
トラブルシュート
簡単に言えば、こちらに行って、ダウンロードして、インストールすれば解決します。先ほどの記事にあるようにパッケージマネージャで取得する必要はありません。
https://www.princexml.com/download/15
私の環境だと.Netframeworkのインストールするように言われました。
なので、結論として、PrinceXML を公式サイトからダウンロードしてインストールするだけで解決します。
パッケージマネージャでの導入は不要です。
解決手順
- PrinceXML 公式ページを開く
https://www.princexml.com/download/15 - Windows 用インストーラをダウンロード
- インストールを実行
※ 私の環境では、途中で .NET Framework の追加インストールが必要でした。 - VS Code を再起動し、再度 PDF 出力を実行
以上でエラーは解消され、PDF が正常に生成されるようになりました。
おすすめ商品：
by Amazon ナチュラルミネラルウォーター ラベルレス 500ml 36本
- Markdown Preview Enhancedでprinceを利用してPDF化するときに日本語が文字化けする
https://qiita.com/rrr/items/9b938f7b58d609f32e62 - PrinceXML 公式ダウンロードページ
https://www.princexml.com/download/15
QandA
Q. パッケージマネージャ（npm / choco / winget）は必要？
→ 不要。公式インストーラでOK。
Q. VS Code 側の設定変更は必要？
→ 基本不要。再起動のみ。
環境
Windows 11 Pro 23H2
Visual Studio Code
Markdown Preview Enhanced
備考
なお、このエラーは
“princexml is required to be installed”
“princexml vscode”
などの文言で検索されることが多いようですが、
原因と対処法はすべて同じです。
