ミッション
ミッション
ブラウザさえあれば、アカウントも購読もアップロードもなしに、Markdown からきれいな PDF を作れるようにする。変換を理解可能に保つ。文書を見て、テーマを選び、何が印刷されるのかを正確に知れるようにする。
md2pdf について
成り立ち
md2pdf はよくある問題から始まりました。画面では快適に読める文書が、送信・保存・印刷の段階で崩れてしまうという問題です。
Markdown は、送り先が PDF を求めるまでは可搬です。ブラウザの印刷ダイアログはページを残しますが、文書は残しません。ナビゲーションが混ざり、相対画像が壊れ、横長のコードブロックが切れ、表が不自然な位置で分割されます。デスクトップの変換ツールは一部を解決しますが、多くの場合インストール、アカウント、サーバーへのアップロードを求めます。
md2pdf はもっと狭い道を選びます。Markdown を読み、リポジトリからの相対パスを解決し、GitHub 風の Markdown をブラウザで描画し、結果を無害化し、印刷用スタイルを適用して、ブラウザ自身の PDF エンジンに渡します。公開 README の取得を指示しない限り、原本が端末の外に出ることはありません。
ビジョン
ビジョン
普通の文書を可搬にするために、専用のデスクトップアプリや変換サービスを必要としないウェブ。Markdown はすでに読めて、差分が取れて、長持ちします。PDF は忠実な出口であるべきで、もう一つの囲い込みであってはなりません。
作り手
Girish Lade
md2pdf 作者 · LadeStack
Girish Lade は LadeStack で md2pdf を開発しています。コンバーター、印刷テーマ、文書ブックのワークフロー、このサイトの各言語版を担当しています。
プロジェクトは意図的に小さく自己完結しています。静的な Astro フロントエンド、ブラウザだけで動く変換コード、そして約束ではなく出力を検証するテストスイートです。
このページの肖像欄は本人の写真のために空けています。追加されるまでは、生成画像やストック写真ではなく、ブランドのモノグラムを表示します。
製品の作り
製品の作り
ブラウザ優先
Markdown の解析、無害化、目次の生成、印刷レイアウト、PDF の組み立てはすべて訪問者の端末で実行されます。サイトは静的で、アプリケーション用のバックエンドはありません。
小さく明示的な上限
単一ファイルは 2 MB まで。文書ブックは最大 30 個の Markdown ファイル、1 ファイル 750 KB、合計 6 MB、API リクエスト数にも上限があります。
出力は印刷
最終的な PDF はブラウザ本来の印刷エンジンが生成します。md2pdf は整えた文書と印刷用スタイルを渡すのであって、PDF レンダリングエンジンのふりはしません。
9 言語
インターフェース、ガイド、このページは英語、スペイン語、日本語、韓国語、簡体字中国語、ロシア語、トルコ語、フランス語、ブラジルポルトガル語で公開されています。
実績を、飾らずに
実績を、飾らずに
ロードマップの約束ではなく、すでに提供している機能です。
- 公開 GitHub README の取り込み。既定ブランチの検出と、リポジトリ相対の画像・リンクの書き換えに対応。
- 貼り付け、アップロード、サンプルの各ワークフロー。GitHub 風の表、タスクリスト、フェンス付きコードに対応。
- 4 つの印刷テーマ: Clean、Business、Academic、Dark。
- 3 つ以上の見出しがある文書の自動目次。
- 表紙、順序付き章、検索できる選択、印刷の分離を備えた複数ファイルの文書ブック。
- 章ごとの PDF 書き出しと、サイズ・ファイル数に上限のある ZIP ダウンロード。
- インターフェース、記事、このページの 9 言語版。
- アカウント不要、ローカルまたは貼り付けた Markdown のアップロードなし、サーバー側レンダラーなし。
誰のためか
誰のためか
md2pdf は、ツールチェーンよりも文書が重要なときに役立ちます。
学生と教員
講義ノート、課題、読書資料を、提出または印刷できる PDF にします。
開発者とテクニカルライター
コンバーターをインストールせずに、README、RFC、文書の章を書き出せます。
コンサルタントと小さなチーム
Markdown を第三者サービスに送らず、整った文書を顧客に渡せます。
アーキビスト
上流で変更・消失するかもしれない文書の、読めてページ付けされた写しを残せます。
プライバシー
ローカルファイルと貼り付けた Markdown はブラウザで読み取られ、アップロードされません。公開 GitHub の取得では、README と画像のために GitHub へ匿名リクエストを送ります。非公開リポジトリには対応していません。アカウントはなく、文書に結び付いた変換分析もありません。
アクセシビリティ
ページは意味のあるランドマーク、ラベルの付いた操作要素、視認できるフォーカス、現在のパスを保つ言語切り替えを使います。動きは控えめで、動きを減らす設定を尊重します。印刷用スタイルは見出しを本文と一緒に保ち、可能な範囲でコードブロック、表、画像がページをまたいで分割されないようにします。アクセシビリティは一度きりの主張ではなく、継続的な取り組みとして扱います。
所有
所有
md2pdf は LadeStack の製品です。製品名、サイト、公開されている各言語版は LadeStack に帰属します。ソースリポジトリは github.com/girishlade111/ReadmePDF で公開されています。製品名が md2pdf でも、リポジトリは元の名前のままです。md2pdf は無料で使えます。
連絡先
連絡先
質問、訂正、アクセシビリティの報告を歓迎します。最も確実なのはメールです。GitHub の issue は公開され、検索できます。
- メール admin@ladestack.in
- GitHub github.com/girishlade111
- LinkedIn linkedin.com/in/girish-lade
- LadeStack ladestack.in
文書を入れて、PDF を出す。
アカウント不要。ローカルファイルのアップロードなし。サンプルから始めるか、自分の Markdown を貼り付けるか、公開 README を取得してください。