MarkdownをAsciiDocに変換

Markdownの原稿を、AntoraやAsciiDoctorなどで使われるAsciiDoc記法へ移します。長い技術文書へ進む前の変換と確認に使えます。

Markdown入力

113 文字

AsciiDocプレビュー

変換後のテキスト
= プロジェクトノート

読みやすい文書は、*分かりやすい構造*から始まります。

== 確認すること

* 見出しの階層
* 正しく開くリンク
* 再利用しやすいファイル

> ダウンロード前にプレビューを確認します。
ファイルはこのブラウザタブ内で処理されます。

MarkdownをAsciiDocへ移す手順

共通する文書構造を変換し、AsciiDoc固有機能は出力後に追加します。

01

Markdownを入力

変換したい原稿を貼り付けるか、.mdファイルを開きます。

02

記法を確認

見出し、リスト、リンク、コードブロック、表の変換結果を読みます。

03

ADOCを保存

.adocをダウンロードし、最終的に使うAsciiDoc処理系でレンダリングします。

対応内容

技術文書の基本構造を移行

MarkdownとAsciiDocで対応関係が明確な要素を変換します。

見出し階層Markdownの見出しをAsciiDocのセクション記法へ置き換えます。
リスト・リンク・コード一般的なリスト、リンク、コードブロックをAsciiDoc記法で出力します。
ソースを再編集変換後のテキストを編集し、属性やincludeなどを後から追加できます。
活用例

AsciiDocへ移行する場面

Antoraドキュメント

既存READMEをAsciiDocベースのドキュメントサイトへ取り込みます。

長い技術マニュアル

相互参照や属性を使う前に、既存Markdownの章立てを移します。

記法の比較

同じ原稿を変換し、MarkdownとAsciiDocの表現差を確認します。

よくある質問

MarkdownからAsciiDocへの変換について

AsciiDoc固有の機能も自動で追加されますか?

いいえ。属性、条件分岐、include、複雑な相互参照などは出力後に設計してください。

表は完全に同じになりますか?

単純な表は変換できますが、セル結合や複雑な書式は確認と手直しが必要です。

どの拡張子で保存されますか?

一般的な.adoc形式で保存します。利用するビルド環境の規約も確認してください。