{"id":13521024,"url":"https://github.com/yzane/vscode-markdown-pdf","last_synced_at":"2025-04-06T05:16:47.306Z","repository":{"id":38952104,"uuid":"65667591","full_name":"yzane/vscode-markdown-pdf","owner":"yzane","description":"Markdown converter for Visual Studio Code","archived":false,"fork":false,"pushed_at":"2024-07-14T01:36:34.000Z","size":35993,"stargazers_count":1057,"open_issues_count":276,"forks_count":210,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-30T03:08:23.651Z","etag":null,"topics":["markdown","mermaid","pdf","plantuml","visual-studio-code","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=yzane.markdown-pdf","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yzane.png","metadata":{"files":{"readme":"README.ja.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["vscode-markdown-pdf"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2016-08-14T13:29:34.000Z","updated_at":"2025-03-29T00:33:43.000Z","dependencies_parsed_at":"2024-01-23T02:04:05.756Z","dependency_job_id":"576764fd-d882-4407-9011-8b58643fc5e3","html_url":"https://github.com/yzane/vscode-markdown-pdf","commit_stats":{"total_commits":179,"total_committers":21,"mean_commits":8.523809523809524,"dds":"0.15083798882681565","last_synced_commit":"d50e168f9bc6f05e00382da8670dd43b8a65995a"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yzane%2Fvscode-markdown-pdf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yzane%2Fvscode-markdown-pdf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yzane%2Fvscode-markdown-pdf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yzane%2Fvscode-markdown-pdf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yzane","download_url":"https://codeload.github.com/yzane/vscode-markdown-pdf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247436286,"owners_count":20938533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","mermaid","pdf","plantuml","visual-studio-code","vscode","vscode-extension"],"created_at":"2024-08-01T06:00:26.545Z","updated_at":"2025-04-06T05:16:47.276Z","avatar_url":"https://github.com/yzane.png","language":"JavaScript","readme":"# Markdown PDF\n\nこの拡張機能は Markdown ファイルを pdf、html、png、jpeg ファイルに変換します。\n\n## 目次\n\u003c!-- TOC depthFrom:2 depthTo:2 updateOnSave:false --\u003e\n\n- [仕様変更](#仕様変更)\n- [機能](#機能)\n- [インストール](#インストール)\n- [使い方](#使い方)\n- [拡張機能 設定](#拡張機能-設定)\n- [オプション](#オプション)\n- [FAQ](#faq)\n- [既知の問題](#既知の問題)\n- [Release Notes](#release-notes)\n- [License](#license)\n- [Special thanks](#special-thanks)\n\n\u003c!-- /TOC --\u003e\n\n\u003cdiv class=\"page\"/\u003e\n\n## 仕様変更\n\n- PDFのヘッダーとフッターのデフォルトの日付書式変更\n  - バージョン1.5.0から、ヘッダーとフッターのデフォルトの日付書式がISOベースの書式（YYYY-MM-DD）に変更されました。\n  - この変更は、以前の書式が環境によって異なる可能性があったため、日付表示の一貫性を向上させることを目的としています。\n  - 以前の書式を使用したい場合は、[markdown-pdf.headerTemplate](#markdown-pdfheadertemplate)を参照してください。\n\n## 機能\n\n以下の機能をサポートしています。\n* [Syntax highlighting](https://highlightjs.org/static/demo/)\n* [emoji](https://www.webfx.com/tools/emoji-cheat-sheet/)\n* [markdown-it-checkbox](https://github.com/mcecot/markdown-it-checkbox)\n* [markdown-it-container](https://github.com/markdown-it/markdown-it-container)\n* [markdown-it-include](https://github.com/camelaissani/markdown-it-include)\n* [PlantUML](https://plantuml.com/)\n  * [markdown-it-plantuml](https://github.com/gmunguia/markdown-it-plantuml)\n* [mermaid](https://mermaid-js.github.io/mermaid/)\n\nサンプルファイル\n * [pdf](sample/README.pdf)\n * [html](sample/README.html)\n * [png](sample/README.png)\n * [jpeg](sample/README.jpeg)\n\n### markdown-it-container\n\nINPUT\n```\n::: warning\n*here be dragons*\n:::\n```\n\nOUTPUT\n``` html\n\u003cdiv class=\"warning\"\u003e\n\u003cp\u003e\u003cem\u003ehere be dragons\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n```\n\n### markdown-it-plantuml\n\nINPUT\n```\n@startuml\nBob -[#red]\u003e Alice : hello\nAlice -[#0000FF]-\u003eBob : ok\n@enduml\n```\n\nOUTPUT\n\n![PlantUML](images/PlantUML.png)\n\n### markdown-it-include\n\nInclude markdown fragment files: `:[alternate-text](relative-path-to-file.md)`.\n\n```\n├── [plugins]\n│  └── README.md\n├── CHANGELOG.md\n└── README.md\n```\n\nINPUT\n```\nREADME Content\n\n:[Plugins](./plugins/README.md)\n\n:[Changelog](CHANGELOG.md)\n```\n\nOUTPUT\n```\nContent of README.md\n\nContent of plugins/README.md\n\nContent of CHANGELOG.md\n```\n\n### mermaid\n\nINPUT\n\u003cpre\u003e\n```mermaid\nstateDiagram\n    [*] --\u003e First\n    state First {\n        [*] --\u003e second\n        second --\u003e [*]\n    }\n```\n\u003c/pre\u003e\n\nOUTPUT\n\n![mermaid](images/mermaid.png)\n\n## インストール\n\nMarkdown PDF をインストールして、Visual Studio Code で Markdownファイルを最初に開いた時、Chromium のダウンロードが自動で始まります。\n\nしかしサイズが大きい為 (~170Mb Mac, ~282Mb Linux, ~280Mb Win) 、環境によっては時間がかかります。\nダウンロード中は、ステータスバーに `Installing Puppeteer` のメッセージが表示されます。\n\nもしプロキシを使う必要がある場合、settings.json に `http.proxy` でプロキシを設定し、Visual Studio Code を再起動してください。\n\nダウンロードが上手くいかない場合や、Markdown PDF のバージョンアップの度にダウンロードするのを避けたい場合、[markdown-pdf.executablePath](#markdown-pdfexecutablepath) オプションでインストール済みの [Chrome](https://www.google.co.jp/chrome/) か Chromium を指定してください。\n\n\u003cdiv class=\"page\"/\u003e\n\n## 使い方\n\n### コマンド パレット\n\n1. Markdown ファイルを開きます\n1. `F1` キーを押すか、`Ctrl+Shift+P` キーを入力します\n1. `export` と入力し以下を選択します\n   * `markdown-pdf: Export (settings.json)`\n   * `markdown-pdf: Export (pdf)`\n   * `markdown-pdf: Export (html)`\n   * `markdown-pdf: Export (png)`\n   * `markdown-pdf: Export (jpeg)`\n   * `markdown-pdf: Export (all: pdf, html, png, jpeg)`\n\n![usage1](images/usage1.gif)\n\n### メニュー\n\n1. Markdown ファイルを開きます\n1. 右クリックして以下を選択します\n   * `markdown-pdf: Export (settings.json)`\n   * `markdown-pdf: Export (pdf)`\n   * `markdown-pdf: Export (html)`\n   * `markdown-pdf: Export (png)`\n   * `markdown-pdf: Export (jpeg)`\n   * `markdown-pdf: Export (all: pdf, html, png, jpeg)`\n\n![usage2](images/usage2.gif)\n\n### 自動変換\n\n1. **settings.json** に `\"markdown-pdf.convertOnSave\": true` オプションを追加します\n1. Visual Studio Code を再起動します\n1. Markdown ファイルを開きます\n1. 保存すると自動で変換されます\n\n## 拡張機能 設定\n\n[Visual Studio Code User and Workspace Settings](https://code.visualstudio.com/docs/customization/userandworkspace)\n\n1. メニューから **ファイル \u003e 基本設定 \u003e ユーザー設定 か ワークスペース設定** を選択します\n1. **既定の設定** から markdown-pdf の設定を探します\n1. `markdown-pdf.*` の設定をコピーします\n1. **settings.json** に貼り付け、値を変更します\n\n![demo](images/settings.gif)\n\n## オプション\n\n### List\n\n|Category|Option name|[Configuration scope](https://code.visualstudio.com/api/references/contribution-points#Configuration-property-schema)|\n|:---|:---|:---|\n|[Save options](#save-options)|[markdown-pdf.type](#markdown-pdftype)| |\n||[markdown-pdf.convertOnSave](#markdown-pdfconvertonsave)| |\n||[markdown-pdf.convertOnSaveExclude](#markdown-pdfconvertonsaveexclude)| |\n||[markdown-pdf.outputDirectory](#markdown-pdfoutputdirectory)| |\n||[markdown-pdf.outputDirectoryRelativePathFile](#markdown-pdfoutputdirectoryrelativepathfile)| |\n|[Styles options](#styles-options)|[markdown-pdf.styles](#markdown-pdfstyles)| |\n||[markdown-pdf.stylesRelativePathFile](#markdown-pdfstylesrelativepathfile)| |\n||[markdown-pdf.includeDefaultStyles](#markdown-pdfincludedefaultstyles)| |\n|[Syntax highlight options](#syntax-highlight-options)|[markdown-pdf.highlight](#markdown-pdfhighlight)| |\n||[markdown-pdf.highlightStyle](#markdown-pdfhighlightstyle)| |\n|[Markdown options](#markdown-options)|[markdown-pdf.breaks](#markdown-pdfbreaks)| |\n|[Emoji options](#emoji-options)|[markdown-pdf.emoji](#markdown-pdfemoji)| |\n|[Configuration options](#configuration-options)|[markdown-pdf.executablePath](#markdown-pdfexecutablepath)| |\n|[Common Options](#common-options)|[markdown-pdf.scale](#markdown-pdfscale)| |\n|[PDF options](#pdf-options)|[markdown-pdf.displayHeaderFooter](#markdown-pdfdisplayheaderfooter)|resource|\n||[markdown-pdf.headerTemplate](#markdown-pdfheadertemplate)|resource|\n||[markdown-pdf.footerTemplate](#markdown-pdffootertemplate)|resource|\n||[markdown-pdf.printBackground](#markdown-pdfprintbackground)|resource|\n||[markdown-pdf.orientation](#markdown-pdforientation)|resource|\n||[markdown-pdf.pageRanges](#markdown-pdfpageranges)|resource|\n||[markdown-pdf.format](#markdown-pdfformat)|resource|\n||[markdown-pdf.width](#markdown-pdfwidth)|resource|\n||[markdown-pdf.height](#markdown-pdfheight)|resource|\n||[markdown-pdf.margin.top](#markdown-pdfmargintop)|resource|\n||[markdown-pdf.margin.bottom](#markdown-pdfmarginbottom)|resource|\n||[markdown-pdf.margin.right](#markdown-pdfmarginright)|resource|\n||[markdown-pdf.margin.left](#markdown-pdfmarginleft)|resource|\n|[PNG JPEG options](#png-jpeg-options)|[markdown-pdf.quality](#markdown-pdfquality)| |\n||[markdown-pdf.clip.x](#markdown-pdfclipx)| |\n||[markdown-pdf.clip.y](#markdown-pdfclipy)| |\n||[markdown-pdf.clip.width](#markdown-pdfclipwidth)| |\n||[markdown-pdf.clip.height](#markdown-pdfclipheight)| |\n||[markdown-pdf.omitBackground](#markdown-pdfomitbackground)| |\n|[PlantUML options](#plantuml-options)|[markdown-pdf.plantumlOpenMarker](#markdown-pdfplantumlopenmarker)| |\n||[markdown-pdf.plantumlCloseMarker](#markdown-pdfplantumlclosemarker)| |\n||[markdown-pdf.plantumlServer](#markdown-pdfplantumlserver)| |\n|[markdown-it-include options](#markdown-it-include-options)|[markdown-pdf.markdown-it-include.enable](#markdown-pdfmarkdown-it-includeenable)| |\n|[mermaid options](#mermaid-options)|[markdown-pdf.mermaidServer](#markdown-pdfmermaidserver)| |\n\n### Save options\n\n#### `markdown-pdf.type`\n  - 出力フォーマット: pdf, html, png, jpeg\n  - 複数の出力フォーマットをサポート\n  - Default: pdf\n\n```javascript\n\"markdown-pdf.type\": [\n  \"pdf\",\n  \"html\",\n  \"png\",\n  \"jpeg\"\n],\n```\n\n#### `markdown-pdf.convertOnSave`\n  - 保存時の自動変換を有効にします\n  - boolean. Default: false\n  - 設定の反映には、Visutal Studio Code の再起動が必要です\n\n#### `markdown-pdf.convertOnSaveExclude`\n  - convertOnSave オプションの除外ファイル名を指定します\n\n```javascript\n\"markdown-pdf.convertOnSaveExclude\": [\n  \"^work\",\n  \"work.md$\",\n  \"work|test\",\n  \"[0-9][0-9][0-9][0-9]-work\",\n  \"work\\\\test\"  // 全ての \\ は \\\\ と記述する必要があります。(Windows)\n],\n```\n#### `markdown-pdf.outputDirectory`\n  - 出力ディレクトリを指定します\n  - 全ての `\\` は `\\\\` と記述する必要があります (Windows)\n\n```javascript\n\"markdown-pdf.outputDirectory\": \"C:\\\\work\\\\output\",\n```\n\n  - 相対パス\n    - `Markdownファイル` を開いた場合、ファイルからの相対パスとして解釈されます\n    - `フォルダ` を開いた場合、ルートフォルダからの相対パスとして解釈されます\n    - `ワークスペース` を開いた場合、それぞれのルートフォルダからの相対パスとして解釈されます\n      - [マルチルート ワークスペース](https://code.visualstudio.com/docs/editor/multi-root-workspaces) を参照してください\n\n```javascript\n\"markdown-pdf.outputDirectory\": \"output\",\n```\n\n  - 相対パス (ホームディレクトリ)\n    - パスが `^` で始まっている場合、ホームディレクトリからの相対パスとして解釈されます\n\n```javascript\n\"markdown-pdf.outputDirectory\": \"~/output\",\n```\n\n  - `相対パス`でディレクトリを設定した場合、ディレクトリが存在しなければ作成されます\n  - `絶対パス`でディレクトリを設定した場合、ディレクトリが存在しなければエラーになります\n\n#### `markdown-pdf.outputDirectoryRelativePathFile`\n  - `markdown-pdf.outputDirectoryRelativePathFile` オプションが `true` に設定されている場合、[markdown-pdf.outputDirectory](#markdown-pdfoutputDirectory) で設定した相対パスは、ファイルからの相対パスとして解釈されます\n  - フォルダやワークスペースからの相対パスを避けたい場合に使うことが出来ます\n  - boolean. Default: false\n\n### Styles options\n\n#### `markdown-pdf.styles`\n  - markdown-pdf で使用するスタイルシートのパスを指定します\n  - ファイルが存在しない場合、スキップされます\n  - 全ての `\\` は `\\\\` と記述する必要があります (Windows)\n\n```javascript\n\"markdown-pdf.styles\": [\n  \"C:\\\\Users\\\\\u003cUSERNAME\u003e\\\\Documents\\\\markdown-pdf.css\",\n  \"/home/\u003cUSERNAME\u003e/settings/markdown-pdf.css\",\n],\n```\n\n  - 相対パス\n    - `Markdownファイル` を開いた場合、ファイルからの相対パスとして解釈されます\n    - `フォルダ` を開いた場合、ルートフォルダからの相対パスとして解釈されます\n    - `ワークスペース` を開いた場合、それぞれのルートフォルダからの相対パスとして解釈されます\n      - [マルチルート ワークスペース](https://code.visualstudio.com/docs/editor/multi-root-workspaces) を参照してください\n\n```javascript\n\"markdown-pdf.styles\": [\n  \"markdown-pdf.css\",\n],\n```\n\n  - 相対パス (ホームディレクトリ)\n    - パスが `^` で始まっている場合、ホームディレクトリからの相対パスとして解釈されます\n\n```javascript\n\"markdown-pdf.styles\": [\n  \"~/.config/Code/User/markdown-pdf.css\"\n],\n```\n\n  - オンラインCSS (https://xxx/xxx.css) は JPG と PNG では正しく適用されますが、PDF では問題が発生します [#67](https://github.com/yzane/vscode-markdown-pdf/issues/67)\n\n```javascript\n\"markdown-pdf.styles\": [\n  \"https://xxx/markdown-pdf.css\"\n],\n```\n\n#### `markdown-pdf.stylesRelativePathFile`\n  - `markdown-pdf.stylesRelativePathFile` オプションが `true` に設定されている場合、[markdown-pdf.styles](#markdown-pdfstyles) で設定した相対パスは、ファイルからの相対パスとして解釈されます\n  - フォルダやワークスペースからの相対パスを避けたい場合に使うことが出来ます\n  - boolean. Default: false\n\n#### `markdown-pdf.includeDefaultStyles`\n  - デフォルトのスタイルシート(VSCode, markdown-pdf)を有効にします\n  - boolean. Default: true\n\n### Syntax highlight options\n\n#### `markdown-pdf.highlight`\n  - Syntax highlighting を有効にします\n  - boolean. Default: true\n\n#### `markdown-pdf.highlightStyle`\n  - スタイルシートのファイル名を指定します。例: github.css, monokai.css ...\n  - [ファイル名のリスト](https://github.com/isagalaev/highlight.js/tree/master/src/styles)\n  - [highlight.js demo](https://highlightjs.org/static/demo/)\n\n```javascript\n\"markdown-pdf.highlightStyle\": \"github.css\",\n```\n\n### Markdown options\n\n#### `markdown-pdf.breaks`\n  - 改行を有効にします\n  - boolean. Default: false\n\n### Emoji options\n\n#### `markdown-pdf.emoji`\n  - 絵文字を有効にします [EMOJI CHEAT SHEET](https://www.webpagefx.com/tools/emoji-cheat-sheet/)\n  - boolean. Default: true\n\n### Configuration options\n\n#### `markdown-pdf.executablePath`\n  - バンドルされた Chromium の代わりに実行する Chromium または Chrome のパスを指定します\n  - 全ての `\\` は `\\\\` と記述する必要があります (Windows)\n  - 設定の反映には、Visutal Studio Code の再起動が必要です\n\n```javascript\n\"markdown-pdf.executablePath\": \"C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\"\n```\n\n### Common Options\n\n#### `markdown-pdf.scale`\n  - ページレンダリングのスケール\n  - number. default: 1\n\n```javascript\n\"markdown-pdf.scale\": 1\n```\n\n### PDF options\n\n  - pdf only. [puppeteer page.pdf options](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.pdfoptions.md)\n\n#### `markdown-pdf.displayHeaderFooter`\n  - ヘッダーとフッター表示を有効にします\n  - boolean. Default: true\n  - このオプションを有効にすると、ヘッダーとフッターが両方表示されます\n  - 片方を表示したくない場合は、もう片方の値を削除します\n  - ヘッダー非表示\n    ```javascript\n    \"markdown-pdf.headerTemplate\": \"\",\n    ```\n  - フッター非表示\n    ```javascript\n    \"markdown-pdf.footerTemplate\": \"\",\n    ```\n\n#### `markdown-pdf.headerTemplate`\n  - ヘッダーを出力する為のHTMLテンプレートを指定します\n  - このオプションを使用するには、`markdown-pdf.displayHeaderFooter` を `true` に設定する必要があります。\n  - `\u003cspan class='date'\u003e\u003c/span\u003e` : 日付。フォーマットは環境に依存します\n  - `\u003cspan class='title'\u003e\u003c/span\u003e` : Markdown ファイル名\n  - `\u003cspan class='url'\u003e\u003c/span\u003e` : Markdown フルパスファイル名\n  - `\u003cspan class='pageNumber'\u003e\u003c/span\u003e` : 現在のページ番号\n  - `\u003cspan class='totalPages'\u003e\u003c/span\u003e` : ドキュメントの総ページ数\n  - `%%ISO-DATETIME%%` : 現在の日付と時刻。ISOベース フォーマット (`YYYY-MM-DD hh:mm:ss`)\n  - `%%ISO-DATE%%` : 現在の日付。ISOベース フォーマット (`YYYY-MM-DD`)\n  - `%%ISO-TIME%%` : 現在の時刻。ISOベース フォーマット (`hh:mm:ss`)\n  - Default (version1.5.0以降): Markdown ファイル名 と 日付を `%%ISO-DATE%%` で表示します\n    ```javascript\n    \"markdown-pdf.headerTemplate\": \"\u003cdiv style=\\\"font-size: 9px; margin-left: 1cm;\\\"\u003e \u003cspan class='title'\u003e\u003c/span\u003e\u003c/div\u003e \u003cdiv style=\\\"font-size: 9px; margin-left: auto; margin-right: 1cm; \\\"\u003e%%ISO-DATE%%\u003c/div\u003e\",\n    ```\n  - Default (version1.4.4以前): Markdown ファイル名 と 日付を `\u003cspan class='date'\u003e\u003c/span\u003e` で表示します\n    ```javascript\n    \"markdown-pdf.headerTemplate\": \"\u003cdiv style=\\\"font-size: 9px; margin-left: 1cm;\\\"\u003e \u003cspan class='title'\u003e\u003c/span\u003e\u003c/div\u003e \u003cdiv style=\\\"font-size: 9px; margin-left: auto; margin-right: 1cm; \\\"\u003e \u003cspan class='date'\u003e\u003c/span\u003e\u003c/div\u003e\",\n    ```\n#### `markdown-pdf.footerTemplate`\n  - フッターを出力する為のHTMLテンプレートを指定します\n  - 詳細は、[markdown-pdf.headerTemplate](#markdown-pdfheadertemplate) を参照してください\n  - Default: {現在のページ番号} / {ドキュメントの総ページ数} を表示します\n    ```javascript\n    \"markdown-pdf.footerTemplate\": \"\u003cdiv style=\\\"font-size: 9px; margin: 0 auto;\\\"\u003e \u003cspan class='pageNumber'\u003e\u003c/span\u003e / \u003cspan class='totalPages'\u003e\u003c/span\u003e\u003c/div\u003e\",\n    ```\n\n#### `markdown-pdf.printBackground`\n  - 背景のグラフィックを出力\n  - boolean. Default: true\n\n#### `markdown-pdf.orientation`\n  - ページの向き\n  - portrait(縦向き) or landscape(横向き)\n  - Default: portrait\n\n#### `markdown-pdf.pageRanges`\n  - 出力するページ範囲 例) '1-5, 8, 11-13'\n  - Default: 全ページ\n\n```javascript\n\"markdown-pdf.pageRanges\": \"1,4-\",\n```\n\n#### `markdown-pdf.format`\n  - 用紙のフォーマット\n  - Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6\n  - Default: A4\n\n```javascript\n\"markdown-pdf.format\": \"A4\",\n```\n\n#### `markdown-pdf.width`\n#### `markdown-pdf.height`\n  - 用紙の幅/高さ、 単位(mm, cm, in, px)\n  - このオプションが指定されている場合、markdown-pdf.format オプションより優先されます\n\n```javascript\n\"markdown-pdf.width\": \"10cm\",\n\"markdown-pdf.height\": \"20cm\",\n```\n\n#### `markdown-pdf.margin.top`\n#### `markdown-pdf.margin.bottom`\n#### `markdown-pdf.margin.right`\n#### `markdown-pdf.margin.left`\n  - 用紙の余白、単位(mm, cm, in, px)\n\n```javascript\n\"markdown-pdf.margin.top\": \"1.5cm\",\n\"markdown-pdf.margin.bottom\": \"1cm\",\n\"markdown-pdf.margin.right\": \"1cm\",\n\"markdown-pdf.margin.left\": \"1cm\",\n```\n\n### PNG, JPEG options\n\n  - png and jpeg only. [puppeteer page.screenshot options](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagescreenshotoptions)\n\n#### `markdown-pdf.quality`\n  - jpeg only. イメージの品質を 0-100 の範囲で指定します。 png では無効です。\n\n```javascript\n\"markdown-pdf.quality\": 100,\n```\n\n#### `markdown-pdf.clip.x`\n#### `markdown-pdf.clip.y`\n#### `markdown-pdf.clip.width`\n#### `markdown-pdf.clip.height`\n  - ページの切り抜き領域を指定します\n  - number\n\n```javascript\n// 切り抜き領域のX軸の基点を指定します。ページの左上が原点です。\n\"markdown-pdf.clip.x\": 0,\n\n// 切り抜き領域のY軸の基点を指定します。ページの左上が原点です。\n\"markdown-pdf.clip.y\": 0,\n\n// 切り抜き領域の幅を指定します\n\"markdown-pdf.clip.width\": 1000,\n\n// 切り抜き領域の高さを指定します\n\"markdown-pdf.clip.height\": 1000,\n```\n\n#### `markdown-pdf.omitBackground`\n  - デフォルトの白い背景ではなく、透過によるスクリーンショットのキャプチャーを有効にします\n  - boolean. Default: false\n\n### PlantUML options\n\n#### `markdown-pdf.plantumlOpenMarker`\n  - plantuml パーサーの開始区切り文字\n  - Default: @startuml\n\n#### `markdown-pdf.plantumlCloseMarker`\n  - plantuml パーサーの終了区切り文字\n  - Default: @enduml\n\n#### `markdown-pdf.plantumlServer`\n  - Plantuml server. e.g. http://localhost:8080\n  - Default: http://www.plantuml.com/plantuml\n  - 例えば、PlantUMLサーバをローカルで実行するには次のようにします [#139](https://github.com/yzane/vscode-markdown-pdf/issues/139) :\n    ```\n    docker run -d -p 8080:8080 plantuml/plantuml-server:jetty\n    ```\n    [plantuml/plantuml-server - Docker Hub](https://hub.docker.com/r/plantuml/plantuml-server/)\n\n### markdown-it-include options\n\n#### `markdown-pdf.markdown-it-include.enable`\n  - markdown-it-include を有効にします\n  - boolean. Default: true\n\n### mermaid options\n\n#### `markdown-pdf.mermaidServer`\n  - mermaid server\n  - Default: https://unpkg.com/mermaid/dist/mermaid.min.js\n\n\u003cdiv class=\"page\"/\u003e\n\n## FAQ\n\n### 絵文字 サイズの変更方法は？\n\n1. 以下の設定を markdown-pdf.styles で指定したスタイルシートに追加します。\n\n```css\n.emoji {\n  height: 2em;\n}\n```\n\n### 文字コードの自動判定\n\nVisual Studio Code の `files.autoGuessEncoding` オプションを使うと、文字コードが自動判定されるので便利です。\n\n```javascript\n\"files.autoGuessEncoding\": true,\n```\n\n### 出力ディレクトリ\n\n常に Markdown ファイルからの相対パスのディレクトリに出力したい場合。\n\n例えば、Markdown ファイルと同じディレクトリの \"output\"ディレクトリに出力する場合、次のように設定してください。\n\n```javascript\n\"markdown-pdf.outputDirectory\" : \"output\",\n\"markdown-pdf.outputDirectoryRelativePathFile\": true,\n```\n\n### 改ページ\n\n改ページを挿入するには、以下を使用してください。\n\n``` html\n\u003cdiv class=\"page\"/\u003e\n```\n\n\u003cdiv class=\"page\"/\u003e\n\n## 既知の問題\n\n### `markdown-pdf.styles` option\n* オンラインCSS (https://xxx/xxx.css) は JPG と PNG では正しく適用されますが、PDF では問題が発生します [#67](https://github.com/yzane/vscode-markdown-pdf/issues/67)\n\n\n## [Release Notes](CHANGELOG.md)\n\n### 1.5.0 (2023/09/08)\n* Improve: The default date format for headers and footers has been changed to the ISO-based format (YYYY-MM-DD).\n  * Support different date formats in templates [#197](https://github.com/yzane/vscode-markdown-pdf/pull/197)\n* Improve: Avoid TimeoutError: Navigation timeout of 30000 ms exceeded and TimeoutError: waiting for Page.printToPDF failed: timeout 30000ms exceeded [#266](https://github.com/yzane/vscode-markdown-pdf/pull/266)\n* Fix: Fix description of outputDirectoryRelativePathFile [#238](https://github.com/yzane/vscode-markdown-pdf/pull/238)\n* README\n  * Add: Specification Changes\n  * Fix: Broken link\n\n## License\n\nMIT\n\n\n## Special thanks\n* [GoogleChrome/puppeteer](https://github.com/GoogleChrome/puppeteer)\n* [markdown-it/markdown-it](https://github.com/markdown-it/markdown-it)\n* [mcecot/markdown-it-checkbox](https://github.com/mcecot/markdown-it-checkbox)\n* [leff/markdown-it-named-headers](https://github.com/leff/markdown-it-named-headers)\n* [markdown-it/markdown-it-emoji](https://github.com/markdown-it/markdown-it-emoji)\n* [HenrikJoreteg/emoji-images](https://github.com/HenrikJoreteg/emoji-images)\n* [isagalaev/highlight.js](https://github.com/isagalaev/highlight.js)\n* [cheeriojs/cheerio](https://github.com/cheeriojs/cheerio)\n* [janl/mustache.js](https://github.com/janl/mustache.js)\n* [markdown-it/markdown-it-container](https://github.com/markdown-it/markdown-it-container)\n* [gmunguia/markdown-it-plantuml](https://github.com/gmunguia/markdown-it-plantuml)\n* [camelaissani/markdown-it-include](https://github.com/camelaissani/markdown-it-include)\n* [mermaid-js/mermaid](https://github.com/mermaid-js/mermaid)\n* [jonschlinkert/gray-matter](https://github.com/jonschlinkert/gray-matter)\n\nand\n\n* [cakebake/markdown-themeable-pdf](https://github.com/cakebake/markdown-themeable-pdf)\n","funding_links":["https://github.com/sponsors/vscode-markdown-pdf"],"categories":["Authoring formats","JavaScript"],"sub_categories":["Markdown"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyzane%2Fvscode-markdown-pdf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyzane%2Fvscode-markdown-pdf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyzane%2Fvscode-markdown-pdf/lists"}