Haddock を AsciiDoc に変換
端末内ですべて処理しています — 大きなファイルは少し時間がかかる場合があります。
Haddock は Haskell のドキュメント記法です。ソースのコメントから API ドキュメントを生成します。 AsciiDoc 文書を Markdown・DOCX・PDF へ変換して配布します。
変換のすべてが端末上で完結するため、瞬時に、無制限に、そして本当にプライベート — アカウントも透かしも、サーバーに置かれるファイルもありません。複数ファイルをまとめて変換できます。
Haddock と AsciiDoc の比較
| Haddock | AsciiDoc | |
|---|---|---|
| データ構造 | コメントマークアップ（--、'リンク'、@mono@） | プレーンテキストマークアップ (==、[source]、|===) |
| 型 / スキーマ | UTF-8テキスト | UTF-8テキスト |
| 互換性 | Haskell、Hackage、Pandoc | Asciidoctor、Gitドキュメント、Pandoc |
| 最適な用途 | Haskell API ドキュメント | 技術書および大規模なドキュメントセット |
Haddock を AsciiDoc に変換する方法
- 1
ファイルを選択
Haddock ファイルを選択してください。
- 2
即座に変換
ファイルはまずマークダウン（見出し、リスト、段落を保持する交換形式）に変換され、その後、ターゲット形式に再構築されます。
- 3
結果をダウンロード
AsciiDoc をダウンロード。構造はそのまま、複雑なレイアウトは簡素化されます。
Haddock 形式について
Haddock は Haskell のドキュメント記法です。ソースのコメントから API ドキュメントを生成します。
公開用には HTML、再利用には Markdown への変換が便利です。
+長所
- ✓コードとドキュメントが一体
- ✓型情報を活かせる
- ✓Haskellエコシステム全体の標準
!短所
- −Haskell 専用
- −対応が限られる
- −コメントに埋め込まれている — まず抽出が必要
AsciiDoc 形式について
AsciiDoc は技術文書向けの軽量マークアップです。書籍のような構造も表現でき、HTML・PDF・EPUB などへ出力できます。
Markdown より表現力が高いぶん記法も豊富です。配布や再利用には Markdown/DOCX への変換が便利です。
+長所
- ✓表現力が高い
- ✓多形式へ出力できる
- ✓長文に強い
!短所
- −記法が多い
- −Markdown ほど一般的でない
- −複数の方言（レガシーasciidoc vs asciidoctor）
Haddock を AsciiDoc に変換する理由
Haddock を AsciiDoc に変換する意味は、AsciiDoc の長所が Haddock にできないことを補える点にあります。表現力が高い 一方で Haskell 専用 上の変換ツールを使えば、ファイルはその天秤の正しい側に置かれます。
よくある質問
このHaddock → AsciiDoc 変換ツールは本当に無料ですか？
はい。完全無料で、登録も透かしも 1 日の変換回数制限もありません。サイトは広告で運営されています。
ファイルはサーバーにアップロードされますか？
いいえ。変換は WebAssembly によりブラウザ内で完結します。ファイルが端末から出ることはないため、高速かつプライベートです。
Windows、Mac、iPhone、Android でも使えますか？
はい。モダンブラウザが動けばどの端末でも使えます：Windows、macOS、Linux、Android、iOS に対応し、インストールは不要です。
Haddock から AsciiDoc への変換でレイアウトは保持されますか？
可能な限り保持されます。段落・見出し・リスト・表の構造は解析して再現しますが、フォントの代替や余白の詰めで細部がずれることはあります。
パスワード保護された PDF も変換できますか？
いいえ。開けないファイルの内容にはアクセスできないため、まずパスワードを解除してからアップロード（ここでは読み込み）してください。