Markdown は、文書やメモ、ブログを書くときによく使われる軽量マークアップ言語です。# で見出し、- で箇条書き、バッククォートでコードを書き、静的サイトでは冒頭の front matter にタイトルや日付を書くことも多くあります。ファイル全体をそのまま変換すると、コードの変数名やリンクに含まれる中国語のパスまで変わり、コードが動かなくなったりリンクが切れたりします。このページは Markdown の構造を読み取り、人が読む部分だけを変換します。
変換されるもの
- 本文、見出し、箇条書き、表、引用。
- リンクの文字と、画像の alt テキスト。
- front matter の値。
- 見出しへのページ内リンク(見出しと一緒に変換)。
- 文書に埋め込んだ HTML タグの title や alt などの属性。
そのまま残るもの
- フェンスで囲んだコードブロック、インデントしたコードブロック、インラインコード。コードブロック内のコメントは設定で変換でき、既定では変えません。
- リンクと画像の URL(中国語のパスも含みます)。下の変換例では、リンクの文字が「使用文檔」になっても、リンク先の
docs/使用文档.mdは変わっていません。 - front matter のキー名と、HTML タグそのもの。
文字化けとエディタの互換性
Markdown のエディタや静的サイトジェネレーターは、たいていファイルを UTF-8 として読みます。GBK や Big5 で書かれた古い文書は、自動で判定して UTF-8 にします。改行コードは元のままで、BOM も既定では元のファイルに合わせます。元のファイルが UTF-8 なら、Git で差分を見ても変換した文字のところだけが変わります。
変換例
| 原文 | 変換結果 |
|---|---|
| ## 安装说明 | ## 安裝說明 |
| 请先阅读[使用文档](docs/使用文档.md)。 | 請先閱讀[使用文檔](docs/使用文档.md)。 |
| 运行 `npm install 软件包` 安装依赖。 | 運行 `npm install 软件包` 安裝依賴。 |
|  |  |
| | 名称 | 说明 | | | 名稱 | 說明 | |
| - **注意**:后台程序会自动更新。 | - **注意**:後臺程序會自動更新。 |
OpenCC(s2t)で実際に変換した結果です。
使い方
- .md か .markdown のファイルをページにドロップするか、「ファイルを選択」を押します。一連の文書をまとめて選べます。
- 方向と地域を選びます。台湾の読者向けの文書なら「台湾」を選びます(「地域の用語も変換」は最初からオンです)。
- 必要なら「形式ごとの詳細設定」を開き、コードブロック内のコメントも変換するかどうかを決めます。
- プレビューを確かめてダウンロードします。複数のファイルは「すべてダウンロード(ZIP)」でまとめられます。
注意点
- 「地域の用語も変換」がオンのときは IT の用語も台湾の言い方になり、「程序」は「程式」、「文件」は「檔案」になります。「文件」が書類の意味で使われていても同じように変わるので、技術文書は通して読み返してください。
- 簡体字 1 字に繁体字が複数ある字が単独で出てくると、取り違えることがあり、ファイルには印が付きません。気になる段落は「テキスト」タブに貼り付けて確認してください。
- docs/使用文档.md のようなリンク先は変えません。互いにリンクしている文書は、ファイル名を「元の名前のまま」にしてダウンロードしてください。言語コードを付けると、リンク先の名前と合わなくなります。
よくある質問
コードブロックの中の中国語は変わりますか?
変わりません。フェンスで囲んだコードブロック、インデントしたコードブロック、インラインコードは元のまま残るので、変数名や文字列に影響しません。コードブロック内のコメントも既定では変換せず、詳細設定の「Markdown:コードブロック内のコメントも変換」をオンにすると変換します。
目次のページ内リンクは使えますか?
使えます。見出しへのページ内リンクは見出しと一緒に変換されます。[安装](#安装) は [安裝](#安裝) になり、変換後の見出しと一致します。
front matter はどう変わりますか?
キー名はそのままで、タイトルや概要などの値だけを変換します。値がパスや URL のときは変えません。
文書の中の HTML タグはどうなりますか?
タグそのものは変えず、title や alt などの文字の属性だけを変換します。