Markdownの構文と変換のメリット
Markdownは、プレーンテキストを用いて手軽に文書構造を定義できる軽量マークアップ言語です。見出し、リスト、表、リンク、コードブロック、強調、タスクリストといった一般的な構造を、シンプルな記号で表現できます。
このMarkdownテキストをMicrosoft Word（.docx）やHTMLに変換することで、異なるプラットフォーム間での文書共有や公開が容易になります。例えば、READMEファイル、取扱説明書、メモ、記事などを執筆する著者が、提出先や公開媒体の指定フォーマットに合わせて文書を変換する際に役立ちます。
Wordドキュメントへのマッピングとファイル名規則
本ツールでMarkdownからWordドキュメント（.docx）へ変換する際、Markdownの各要素は対応するWordの文書構造へとマッピングされます。具体的には、見出し、リスト、表、リンク、コードブロック、強調、タスクリストなどの構造が保持された状態でDOCXファイルが生成されます。
書き出されるWordドキュメントのファイル名は、入力されたMarkdown内にある最初のH1見出し（# 見出し）から自動的に決定されます。Markdown内に対象となる見出しが存在しない場合は、「無題のドキュメント」というファイル名が適用されます。
クリーンなHTMLとスタンドアロンファイルの役割
本ツールが生成するHTMLは、余分なインラインスタイルや不要なタグを含まない「クリーンなHTML」です。ダウンロードされるHTMLは、単一のシンプルなスタンドアロンドキュメントとして構成されているため、そのままWebブラウザで閲覧したり、Web開発の素材として利用したりするのに適しています。
また、セキュリティとアクセシビリティへの配慮として、プレビューおよびHTML出力に含まれるリンクには、自動的にnoopener noreferrer属性が付与されます。さらに、Markdown内に記述された生のHTMLは、レンダリングおよびHTMLエクスポートの前にエスケープ処理が施されるため、安全なドキュメント表示が可能です。
ブラウザ内ローカル処理とプライバシー
本ツールにおけるMarkdownの処理、プレビュー表示、HTMLエクスポート、およびWordドキュメントの生成は、すべて利用者のブラウザ内でローカルに実行されます。
入力されたMarkdownテキストや生成されたデータが、外部サーバー（BroBroGoなど）にアップロードされることはありません。プライバシーが保たれた環境で、安全にドキュメントの作成と変換を行うことができます。
変換時のルールとエラーメッセージ
ツールを使用する際、入力エリアの状態やテキストの量に応じて、以下のルールとメッセージが適用されます。
- 入力エリアが空の場合: プレビュー領域には「フォーマットされたプレビューとHTMLがここに表示されます。」と表示されます。
- テキストがない状態でエクスポートを試みた場合: 「書き出す内容がありません。先にMarkdownを入力してください。」というメッセージが表示されます。
- エディタをクリアした場合: ステータスが「エディタをクリアしました。」に変わり、文字数カウントは0にリセットされます。
- テキストサイズが制限を超えた場合: ローカルでのWord書き出し制限を超えると、「このMarkdownはローカルでのWord書き出し制限を超えています。
{max}文字未満に抑えてください。」というエラーが表示されます。 - 変換処理自体に失敗した場合: 「変換に失敗しました。より小さいMarkdownドキュメントでお試しください。」というメッセージが表示されます。
よくある質問（FAQ）
入力したMarkdownはアップロードされますか？ いいえ。プレビュー、HTML書き出し、Wordドキュメント生成はすべてお使いのブラウザ内でローカルに実行されます。
Word書き出しでは何が保持されますか？ DOCX書き出しでは、見出し、リスト、表、リンク、コードブロック、強調、タスクリストなどの一般的なMarkdown構造が保持されます。
HTML書き出しに安全でないスクリプトは含まれますか？ いいえ。Markdown内の生のHTMLはレンダリング前にエスケープされ、ダウンロードされるHTMLはシンプルなスタンドアロンのドキュメントになります。