Haddock を AsciiDoc に変換
端末内ですべて処理しています — 大きなファイルは少し時間がかかる場合があります。
Haddock は Haskell のドキュメント記法です。ソースのコメントから API ドキュメントを生成します。 AsciiDoc 文書を Markdown・DOCX・PDF へ変換して配布します。
変換のすべてが端末上で完結するため、瞬時に、無制限に、そして本当にプライベート — アカウントも透かしも、サーバーに置かれるファイルもありません。複数ファイルをまとめて変換できます。
How Haddock compares to AsciiDoc
| Haddock | AsciiDoc | |
|---|---|---|
| Structure | Comment markup (--, 'links', @mono@) | Plain-text markup (==, [source], |===) |
| Types / schema | UTF-8 text | UTF-8 text |
| Compatibility | Haskell, Hackage, Pandoc | Asciidoctor, Git docs, Pandoc |
| Best for | Haskell API documentation | Technical books and large doc sets |
Haddock を AsciiDoc に変換する方法
- 1
ファイルを選択
- 2
即座に変換
- 3
結果をダウンロード
Haddock 形式について
Haddock は Haskell のドキュメント記法です。ソースのコメントから API ドキュメントを生成します。
公開用には HTML、再利用には Markdown への変換が便利です。
+長所
- ✓コードとドキュメントが一体
- ✓型情報を活かせる
- ✓Standard for the entire Haskell ecosystem
!短所
- −Haskell 専用
- −対応が限られる
- −Embedded in comments — needs extraction first
AsciiDoc 形式について
AsciiDoc は技術文書向けの軽量マークアップです。書籍のような構造も表現でき、HTML・PDF・EPUB などへ出力できます。
Markdown より表現力が高いぶん記法も豊富です。配布や再利用には Markdown/DOCX への変換が便利です。
+長所
- ✓表現力が高い
- ✓多形式へ出力できる
- ✓長文に強い
!短所
- −記法が多い
- −Markdown ほど一般的でない
- −Multiple dialects (legacy 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 も変換できますか？
いいえ。開けないファイルの内容にはアクセスできないため、まずパスワードを解除してからアップロード（ここでは読み込み）してください。