Markdown HTML変換の使い方
- 左側の入力欄にMarkdown記法で文章を書くか、README.mdの内容を貼り付けます。
- 右側のプレビューで表示を確認し、HTMLコードタブで変換後のタグを確認します。
- HTMLをコピーを押してブログのHTML編集画面やメールテンプレートに貼り付けるか、.htmlファイルで保存を押してブラウザで開きます。
- 入力中の内容はこのブラウザに自動保存されるので、次に開いたときも残っています。
Markdown記法まとめ(よく使う書き方)
| 表現 | Markdown | HTMLの結果 |
|---|---|---|
| 見出し | # 見出し1、## 見出し2 | <h1>、<h2> |
| 太字/斜体 | **太字**、*斜体* | <strong>、<em> |
| 取り消し線 | ~~取り消し~~ | <del> |
| リンク | [Tooljip](https://tooljip.com) | <a href> |
| 画像 |  | <img> |
| リスト | - 項目、1. 項目 | <ul>、<ol> |
| チェックリスト | - [x] 完了 | チェックボックス付きリスト |
| 引用 | > 引用文 | <blockquote> |
| インラインコード | `code` | <code> |
| コードブロック | ```js … ``` | <pre><code> |
| 表 | | 名前 | 値 ||---|---| | <table> |
| 水平線 | --- | <hr> |
MarkdownがHTMLに変換されるルールと注意点
Markdownは、人が読みやすい記号で文書の構造を書き、変換ツールがそれをHTMLタグに置き換える仕組みです。Tooljipでは広く使われているmarkedライブラリのGitHub形式(GFM)のルールを採用しています。そのため、GitHubのREADMEとほぼ同じ結果になります。
- 改行:Enterを1回押しただけでは同じ段落として続きます。段落を分けるには空行を1行入れてください。
- リストのインデント:入れ子のリストは半角スペース2〜4個でインデントします。
- 記号をそのまま表示:
*や#を文字として表示するには、前にバックスラッシュ(\*)を付けます。日本語キーボードでは円記号(¥)キーで入力できます。 - HTMLを直接書く:Markdownの中にHTMLタグを混ぜて書けます。混ぜたタグは結果のコードにそのまま残ります。
- 全角スペースに注意:インデントや記号の後のスペースが全角だと、Markdownとして認識されません。必ず半角スペースを使ってください。
プレビューは安全に隔離されています
ほかの場所からコピーしたMarkdownに<script>などのコードが含まれていても、Tooljipのプレビューはスクリプトを実行しない隔離された領域(sandbox iframe)に表示されます。そのため、プレビューを見るだけでブラウザに影響が及ぶことはありません。
ただし、変換したHTMLコードを自分のWebサイトにそのまま掲載する場合は別です。外部から受け取ったMarkdownを掲示板やサービスで使うときは、サーバー側で許可したタグだけを残す処理(サニタイズ)を必ず行ってください。
ブログ・README作成に活用する
GitHubのREADMEやQiita・Zennの技術記事、Notion・Obsidianのメモなど、Markdownを使う場面はたくさんあります。一方で、ブログサービスのHTML編集画面やメールマガジンの配信ツールのように、HTMLしか受け付けない場面もあります。Markdownで素早く下書きを書き、このツールでHTMLに変換して貼り付ければ、書式を整える手間を大幅に減らせます。文章の長さが気になる場合は文字数カウントで確認してみてください。
よくある質問
GitHubのREADMEのプレビューとして使えますか?
はい、使えます。GitHub Flavored Markdown(表、チェックリスト、取り消し線、自動リンク)に対応しているので、ほとんどの場合は同じ見た目で表示されます。ただし、GitHub独自の機能(Issue番号の自動リンク、数式、ダイアグラム)には対応していません。
「完全なHTML文書として保存」にすると何が違いますか?
チェックを入れると、<html>・<head>、文字コード設定(UTF-8)、基本スタイルを含むファイルとして保存されます。日本語も文字化けせず、そのままブラウザで開けます。チェックを外すと本文のタグだけを保存するので、ほかのページに埋め込むときに便利です。
入力したMarkdownは保存されますか?
入力中の内容はこのブラウザ内にだけ自動保存され、サーバーには送信されません。クリアボタンを押すと、保存された内容も一緒に削除されます。
HTMLをMarkdownに変換することもできますか?
現在対応しているのは、MarkdownからHTMLへの変換だけです。HTMLコードをMarkdownに変換する機能はありません。
インデントしたのにリストが入れ子になりません。
インデントに全角スペースを使っていないか確認してください。Markdownでは半角スペース(2〜4個)でインデントする必要があります。