MarkdownからHTMLへの公開: GFM構文カバレッジとインラインスタイルガイド

GFMはGitHubが定義するMarkdownの拡張仕様であり、基本構文に加えて4種類の一般的な拡張が含まれています。OKfmtのMarkdownからHTMLへのコンバーターは、4種類すべての拡張について完全なフォーマット変換をサポートし、標準的な意味に一致するHTMLタグを出力します。

4種類の拡張は、配置属性付きテーブル、取り消し線テキスト、タスクリスト、囲まれたコードブロックです。変換後も元の構文の構造とスタイル情報が保持され、大半の公開コンテンツ公開プラットフォームの表示要件を満たします。

OKfmtのMarkdownからHTMLへのコンバーターは、デフォルトでDOCTYPE宣言を含む完全なHTML5ドキュメントを出力し、すべての文字組みスタイルはインラインCSSとして対応するタグに書き込まれます。変換結果は外部スタイルシートに依存せずとも正常に表示されます。

この出力形式は、外部スタイルをサポートしない公開シナリオ、例えば企業内部のメール本文、カスタムCSSを許可しないコンテンツ管理システム、第三者ブログプラットフォームのリッチテキスト編集領域などに適しています。ユーザーは変換されたHTMLコードをコピーして直接貼り付けて公開することができます。

一部のMarkdownエディターは、コンテンツに生HTMLタグを埋め込むことを許可しています。これらのタグには悪意のあるスクリプトコードが含まれている可能性があり、公開ページにセキュリティリスクをもたらします。OKfmtは入力された生HTMLタグをレンダリングしない保護機構を採用しています。

ツールは入力コンテンツ内の生HTMLタグをエスケープしてプレーンテキストとして出力し、変換後のHTMLドキュメント内でタグが実行されることを防止し、XSSクロスサイトスクリプティングインジェクション攻撃を回避して、公開ページのアクセス安全性を確保します。

OKfmtのMarkdownからHTMLへのコンバーターはフォーマット変換のみを実行し、画像リソースの転送やストレージは処理しません。変換中、元のMarkdownコンテンツに含まれる画像リンクアドレスは保持され、生成されるHTMLのimgタグのsrc属性に直接書き込まれます。

ユーザーは元の画像を自身でターゲットプラットフォームの画像ホスティングまたはストレージサーバーにアップロードした後、対応するリンクアドレスを置き換える必要があります。ツール自体はユーザーがアップロードしたいかなるコンテンツも保存せず、すべての変換処理はユーザーのローカルブラウザ内で完了します。

OKfmtはHTMLからMarkdownへの逆のフォーマット変換サービスも提供しています。このサービスの主な適用シナリオは、公開WebコンテンツのMarkdownアーカイブです。ユーザーはWebページのテキストのHTMLコンテンツをコピーして変換し、構造化されたMarkdownテキストとして保存することができます。

変換プロセスでは、見出しレベル、リスト、リンク、画像を含む元のコンテンツの構造が保持され、Webページに付随するナビゲーションや広告などの冗長なコードが削除されます。変換後のMarkdownは個人の知識ノートのアーカイブに利用したり、二次編集後に再公開したりすることができます。