How do I convert Markdown to PDF in Make?

Add the PDF4me Convert Markdown to PDF module to a Make scenario, connect it, map File Name and Document from a prior download step, and run the scenario. The module returns a rendered PDF on the Document field with no manual conversion step.

Can I convert a ZIP file of Markdown documents at once?

The module converts one Markdown file per run, but that file can come from inside a ZIP archive when you set Markdown File Path to the relative path of the .md file in the ZIP. To convert a folder of separate .md files, run the module once per file inside a Make Iterator.

Why don't my images show up in the converted PDF?

Images referenced by a relative path in the Markdown source may not resolve when the PDF is rendered. Use absolute URLs for embedded images so they load correctly in the output PDF.

What Markdown formatting does the module support?

The module preserves GitHub-flavored Markdown elements including headings, ordered and unordered lists, bold and italic emphasis, inline code, fenced code blocks, tables, and blockquotes in the rendered PDF.

変換する Markdown に PDF で Make

変換する Markdown に PDF は Make モジュール PDF4me .md ファイルまたは ZIP アーカイブ Markdown 磨き上げられた PDF 自動化シナリオ内のドキュメント。これを使用して、README ファイル、技術ドキュメント、または wiki エクスポートを公開します。 PDFs. このモジュールは、出力において見出し、コードブロック、表、および強調表示を保持します。

認証 API リクエスト

アクセスするには PDF4me ウェブ API を通して Makeすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、承認されたユーザーとしての身元が検証され、シームレスな統合が可能になります。 Make シナリオと PDF4meの Markdown 変換サービス。

Get your API Key

見逃してはならない重要な事実

ZIP 入力にはMarkdownファイルパスフィールドが必要です

ドキュメントが.zipアーカイブの場合は、Markdownファイルパスにその中の.mdファイルへの相対パスを入力します。例: docs/README.md. 直接 .md ファイルの場合は空のままにしてください。 ZIP 入力によってモジュールがエラーになります。

GitHub風の書式設定は保持されます

見出し、リスト、太字と斜体の強調表示、インラインコード、フェンス付きコードブロック、表、引用ブロックはすべて正しく表示されます。相対パスで参照された画像は読み込まれない場合があるため、絶対パスを使用してください。 URL埋め込み画像用のs。

イテレータを使用してドキュメントセット全体を変換します

このモジュールは、 Markdown 実行ごとに1つのファイルずつ処理します。.mdファイルのフォルダを処理するには、このモジュールの前にRepeaterまたはIteratorを配置して、各イテレーションで1つのファイルが渡されるようにします。

PDF4meのMarkdownからPDFへの変換モジュールで、接続、ファイル名、ドキュメント、Markdownファイルパスの各フィールドが表示されます。 — 選択してください PDF4me 接続、前のダウンロード手順からのファイル名とドキュメントのマッピング、そしてドキュメントがMarkdownファイルパスである場合にのみMarkdownファイルパスを設定します。 ZIP アーカイブ。

Convertとは何ですか？ Markdown に PDF で Make？

変換する Markdown に PDF は Makeの PDF4me レンダリング用モジュール Markdown ソースを PDF プログラムでドキュメントを作成します。.md ファイルまたは ZIP バイナリバッファとしてアーカイブし、フォーマットされたデータを返します。 PDF単発のオンラインコンバーターとは異なり、このモジュールは自動化されたシナリオ内で実行されるため、新しい README、ドキュメントの更新、または wiki のエクスポートごとに、 PDF 手動操作なしのバージョン。

パラメータ

パラメータ	必須	その機能	例
Connection	Required	PDF4me connection holding your API key. Create one from the Make Connections panel using your key from dev.pdf4me.com/dashboard.	`TestUser01`
File	Required	How the source Markdown file reaches the module. The radio lists your connected storage actions (for example Dropbox - Download a File) and Map. Choose Map to wire the fields below from earlier modules: File Name and Document only appear once Map is selected.	`Map`
File Name	Required	Markdown filename with a .md extension, or .zip for a ZIP archive containing Markdown. Map it from the prior module output. Drives the output PDF name.	`README.md`
Document	Required	Binary Markdown or ZIP file content as a Make buffer. Map from the Data field of a GitHub, GitLab, Dropbox, or HTTP download module.	`1. Data`
Markdown File Path	Optional	Relative path to the .md file inside a ZIP archive. Needed only when Document is a ZIP; leave empty for a direct .md file.	`docs/README.md`

出力

分野	タイプ	内容物
Name	`File name`	Output PDF filename derived from the Markdown source filename. Use it in the destination upload module File Name field.
Document	`File (binary data)`	Binary PDF content rendered from the Markdown source. Map directly into a cloud-storage upload module, an email attachment, or a merge step.

Convert はどのように Markdown に PDF 働く Make？

モジュールは Markdown バッファにマッピングすると、見出し、リスト、テーブル、コードブロック、強調が固定レイアウトにレンダリングされ、結果がストリームとして返されます。 PDF ドキュメントフィールドで。 ZIP 入力すると、まずMarkdownファイルパスで指定されたファイルを抽出し、次にそのファイルのみをレンダリングします。 Markdown それ自体が CommonMark仕様GitHub のフレーバーは、テーブルとタスクリストで拡張されており、以下に記載されています。 GitHubのMarkdownガイドシナリオ構築パターンについては、以下を参照してください。ヘルプセンターを作成する。

典型的な構成

GitHubリリースのREADME PDF

GitHubリポジトリで新しいリリースが作成されたときにトリガーする。
リポジトリからREADME.mdをダウンロードしてください。
ファイル名とドキュメントを変換に渡す Markdown に PDF。
返却されたものを添付してください PDF GitHubのリリースアセットへ。

ドキュメントフォルダを一括変換する

GitLabまたはDropboxのリストモジュールを使用して、docsフォルダ内のすべての.mdファイルを一覧表示します。
リストを順に処理し、各ファイルをダウンロードします。
変換を実行 Markdown に PDF 各反復処理において。
各 PDF ドキュメントポータルまたは共有ドライブへ。

Wiki をアーカイブしてエクスポートする PDF

wikiページをエクスポート ZIP の Markdown ConfluenceまたはGitLab wikiからのファイル。
地図 ZIP バッファをドキュメントに設定し、Markdownファイルパスを目的のページに設定します。
変換を実行 Markdown に PDF 各ページパスについて。
結果を保存する PDFGoogleドライブのアーカイブフォルダに保存されています。

実践的なヒント

Markdownファイルパスを設定するのは ZIP 入力

ドキュメントが直接 .md ファイルの場合は空欄のままにしてください。 ZIP 入力によってモジュールがレンダリングするファイルを見つけられず、エラーが発生します。

絶対イメージを使用する URLs

相対画像パス Markdown レンダリング時にソースが解決されない可能性があります。画像参照を完全な https:// に指定してください。 URL そのため、それらは PDF。

ファイル名にファイル拡張子を残してください

ファイル名に「.md」または「.zip」を含めることで、モジュールおよび下流のモジュールがソース形式を正しく認識できるようになります。

複数のファイルに対して反復処理を行う

このモジュールは1つをレンダリングします Markdown 実行ごとにソースを指定します。フォルダ内の .md ファイル全体を処理するには、その前に Repeater または Iterator を配置します。

変換ごとに消費されるクレジット

各実行で消費される PDF4me プランのクレジットをご利用ください。大規模なバッチ変換を行う前に、ダッシュボードの使用状況をご確認ください。

チートシート

分野	価値
Module	`PDF4me > Convert Markdown to PDF`
Connection	`Your PDF4me connection (key from dev.pdf4me.com/dashboard)`
File Name	`README.md`
Document	`1. Data (binary from prior download)`
Markdown File Path	`docs/README.md (ZIP input only)`
Output	`Document (rendered PDF buffer)`

よくある質問

変換するにはどうすればいいですか？ Markdown に PDF で Make？+

追加する PDF4me 変換する Markdown に PDF モジュールを Make シナリオを接続し、以前のダウンロード手順からファイル名とドキュメントをマッピングして、シナリオを実行します。モジュールはレンダリングされた結果を返します。 PDF ドキュメントフィールドに対して、手動変換の手順は不要です。

変換できますか ZIP ファイル Markdown 書類を一度に？+

このモジュールは、 Markdown 実行ごとにファイルですが、そのファイルは内部から取得できます ZIP Markdown ファイルパスを .md ファイルの相対パスに設定すると、アーカイブが ZIP個別の .md ファイルのフォルダーを変換するには、モジュールをファイルごとに 1 回実行します。 Make イテレータ。

変換された画像が表示されないのはなぜですか？ PDF？+

相対パスで参照される画像 Markdown ソースが解決されない場合がある PDF レンダリングされます。絶対値を使用してください。 URL埋め込み画像が正しく出力に読み込まれるようにするためのs PDF. GitHub Markdown ガイド画像構文について詳しく解説しています。

このモジュールはどのようなMarkdownフォーマットをサポートしていますか？+

このモジュールはGitHubフレーバーを保持します Markdown 見出し、順序付きリストと順序なしリスト、太字と斜体の強調、インラインコード、フェンス付きコードブロック、表、引用ブロックなどの要素は、 CommonMark仕様 GitHub Flavored Markdownが拡張しているもの。