Markdownの基本構文とドキュメント構造
Markdownは、プレーンテキストに対して軽量なマークアップを施すことで、構造化された文書を作成するための仕様です。この変換ツールでは、見出し、リスト、表（テーブル）、コードブロック、引用（ブロッククォート）、リンク、画像、強調（太字など）、そしてGitHubスタイルのタスクリストといった主要な構文に対応しています。
適切な文書構造を設計する際は、情報の階層化が重要です。最上位の見出し（#）から順に、中見出し（##）、小見出し（###）と段階的に配置することで、読み手にとって理解しやすいドキュメントになります。また、箇条書きリストや番号付きリスト、データを整理するための表、プログラムコードを等幅で表示するコードブロックなどを組み合わせることで、技術文書やマニュアル、README、レポートなどの作成が効率的に行えます。
ブラウザによるPDF生成と印刷の仕組み
本ツールにおけるPDFへの変換は、Webブラウザが標準で備えている印刷エンジンを利用して実行されます。
ユーザーが「PDFを書き出し」をクリックすると、ブラウザの印刷ダイアログが起動します。このダイアログにおいて、送信先（プリンター）の選択肢から「PDFとして保存」を指定することで、画面上のプレビュー内容がそのままPDFファイルとして書き出されます。この仕組みにより、特別なPDF生成サーバーを介することなく、お使いのデバイス上で直接ファイルが生成されます。
クライアントサイド処理によるプライバシーと速度のメリット
本ツールにおけるデータの解析、プレビューの生成、およびPDFへの書き出し処理は、すべてユーザーが使用しているWebブラウザの内部でローカルに実行されます。
Markdownはブラウザ内で処理されます。BroBroGoにアップロードされることはありません。外部のサーバーにテキストデータを送信しないため、ネットワークの通信状況に左右されず、高速にプレビューや変換処理が行われます。
リアルタイムプレビューとエディタの機能
本ツールは、入力されたMarkdownテキストを即座に解析し、整形後の外観を表示する「リアルタイムプレビュー」機能を備えています。
エディタ部分には以下の機能と仕様が組み込まれています。
- 表示モードの切り替え: 「編集」ビューと「プレビュー」ビューを切り替えて作業することができます。
- ダークモード: エディタの背景を暗くする「ダークエディタ」を選択可能です。
- 文字・単語カウント: エディタ内のテキストに基づいて、「単語数」および「文字数」がリアルタイムで計測・表示されます。
- クリア機能: 「クリア」をクリックすると、文字数と単語数のカウントはゼロにリセットされ、プレビュー領域には「フォーマットされたプレビューがここに表示されます。」と表示されます。このとき、ステータス欄には「エディタをクリアしました。」と表示されます。
初期状態やリセット時には、ステータスとして「準備完了。Markdownを入力または貼り付けると、リアルタイムでプレビューが表示されます。」と表示されます。また、エディタが空の状態で「PDFを書き出し」をクリックした場合は、印刷ダイアログは開かず、「書き出す内容がありません。先にMarkdownを入力してください。」というエラーメッセージが表示されます。
選択可能なテキストとリンクの保持
本ツールで生成されるPDFは、画面をキャプチャしただけの画像データ（ラスタライズされたPDF）ではありません。ブラウザの印刷エンジンを介してテキスト情報を保持したまま出力されるため、完成したPDF内のテキストは、閲覧時にマウスでドラッグして選択・コピーすることが可能です。また、Markdown内で設定したハイパーリンクも機能が維持されるため、PDF上でリンクをクリックして対象のWebページに遷移することができます。
よくある質問
入力したMarkdownはアップロードされますか？
いいえ。解析、プレビュー、PDF書き出しはすべてお使いのブラウザ内でローカルに実行されます。
PDFファイルを取得するにはどうすればよいですか？
「PDFを書き出し」をクリックします。ブラウザの印刷ダイアログが開くので、送信先として「PDFとして保存」を選択してください。
PDF内のテキストは選択可能ですか？
はい。書き出しにはブラウザ標準の印刷エンジンを使用するため、画像化されたPDFではなく、テキストの選択やリンクのクリックが可能なPDFが作成されます。
どのようなMarkdown機能に対応していますか？
見出し、リスト、表、コードブロック、引用、リンク、画像、強調、およびGitHubスタイルのタスクリストに対応しています。
エクスポートされたPDFのタイトルはどうなりますか？
PDFは、Markdown内の最初の「#」見出しをタイトルおよび推奨ファイル名として使用します。Markdownに最上位の見出しがない場合は、「無題のドキュメント」としてエクスポートされます。