Markdownは,シンプルなテキストを構造化された文書に変換する軽量なテキストフォーマットシンタックスです. 2004年にジョン・グルーバーによって作成され,現在はドキュメント, README ファイル,ブログ投稿,開発者通信のための標準フォーマットです. このガイドでは Markdown が何であるか,なぜ人々がそれを使うのか,そしてどのように始められるかを説明します.
マークダウン は 何 です か
Markdownは,シンプルな点字を用いた素文字にフォーマットを加える方法です. テキストエディターに書き込み, Markdown はプロセッサによってフォーマットされた出力 (HTML, PDF,など) に変換されます.
例えば:
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item twoレンダリングは:
これは"タイトル"です
これは ボールドワード そしてこれは italic.
- リストの第一項
- リスト第2項
隠されたXMLも バイナリーフォーマットも 独占的なコードもありません
なぜ Markdown が 創造 さ れ まし た か
Markdownの前に,ウェブライターは選択に直面していました. HTML (退屈でエラーに易い) で原稿を書くか, WYSIWYG エディタを使って 混沌としたコードを生成するか. ジョン・グルーバーは Markdown を設計した.
- 読み取れるように レンダリングなしでも
**bold**強調として明確に読み取れます - 誰でも書くことができる 特殊なソフトウェアはなく,テキストエディターだけです
- HTMLに変換可能 主な出力フォーマット
当初の仕様はクリーンな HTML を生産することに焦点を当てました. しかし Markdownは数十のプラットフォームと出力フォーマットに広がりました
Markdown は どこ で 用い られ ます か
Markdownはテクノロジーに至る所にあります.
| プラットフォーム | Markdown が何をしているか |
|---|---|
| GitHub | README,問題,プルリクエスト,ウィキ |
| Notion | ページの内容とドキュメント |
| Obsidian | 貯蔵庫にある全てのメモ |
| WordPress について | Markdownプラグインで投稿 |
| GitBook | ドキュメンテーションページ |
| スラック / ディスコード | メッセージのフォーマット |
| スタックオーバーフロー | 質問と答え |
| ジェキル / ヒューゴ / アストロ | ブログ記事や静的なページ |
| ジュピターノートブック | ドキュメンテーション セル |
テクニカルなコンテンツを書いていると 間違いなく Markdown に遭遇しました
Markdown 対 Word: 重要な違い
| アスペクト | Word | Markdown |
|---|---|---|
| フォーマット | バイナリー (.docx) | 単行本 (.md) |
| 移動可能 | Word または対応するアプリが必要です | どのテキストエディターでも開きます |
| バージョン制御 | 難しい (バイナリ・ディフス) | 簡単 (行ごとに Git の差異) |
| レンダリング | アプリに組み込まれている | Markdown レンダリングが必要 |
| 学習曲線 | WYSIWYG (学習なし) | シンタキシスを学ぶ必要 |
| プラットフォームのサポート | マイクロソフトエコシステム | ユニバーサル 開発ツール |
Wordの文書を Markdownに変換したい場合は, WordToMD 登録もアップロードもなし
基本 Markdown 構文
最も一般的な要素は次のとおりです
タイトル
# Heading 1
## Heading 2
### Heading 3参照 Markdown タイトルガイド 完全な参照のために.
強調する
**Bold text**
*Italic text*
~~Strikethrough~~リスト
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. Thirdリンク
[Link text](https://example.com)画像
コード
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |ブロッククォーツ
> This is a blockquote.
> It can span multiple lines.Markdown 味
Markdownは単一の標準ではありません. にはいくつかのバリエンスがあります.
- CommonMark 厳格で曖昧な仕様
- GitHub 味付けされた Markdown (GFM) CommonMark + テーブル,タスクリスト,ストライクスルー,オートリンク
- マルチマークダウン 脚注,引用,メタデータを追加する
- パンドック・マークダウン Pandoc 変換器で使用される最も機能豊富な
ほとんどのプラットフォームは少なくとも CommonMark をサポートしています. GitHub, Obsidian,そして GitBookは GFMを使用します. 完全な参考文献は Markdown 構文 チートシート.
マークダウンの 書き方
特別なソフトウェアは必要ありません 選択肢は以下のとおりです
- VS コード 組み込み Markdown プレビューを備えた無料で強力なエディター
- Obsidian Markdown グラフ表示のメモアップ
- ティポラ WYSIWYG Markdown エディター
- iA 作家 集中的な書き込み環境
- 任意のシンプルなテキストエディター ノートパッド, TextEdit, vim, emacs
Markdown と他のフォーマット間の変換
Markdownに変換する Word ドキュメントがある場合, WordToMD 完全に無料で ファイルアップロードなしで
逆 (Markdown to Word or PDF) の場合, Pandoc のようなツールがこの変換を処理します. 参照 Pandoc Word から Markdown 設定の指示のために
FAQ
Markdown はプログラミング言語ですか? - 違うわ Markdownはマークアップ言語で 論理や計算ではなく,フォーマットを記述する.
マークダウンは使用できますか? Wordは Markdownをネイティブにレンダリングしませんが, Markdownをサポートする Wordアドインがあります. または Word を Markdown に変換します WordToMD そして Markdown エディタを使用します
Markdownは長い文書に適していますか? そうだ いい方向構造がある 非常に長いドキュメントは複数のファイルに分割される ( GitBook または Obsidian 貯蔵庫のように) から利益を得ます.
Markdown はどのファイル拡張子を使用しているのですか?
.md 標準的なものです .markdown これはまた有効です. いくつかのプラットフォームは .mdx JSX (React) コンポーネントを持つ Markdown に対して
結論
Markdownはシンプルで強力な形式で 専門的な執筆の通用言語となっています シンプルなテキストとして読み取れます 美しいレンダリングがあり,すべての主要な開発ツールを使用できます 始めましょう. Markdown 構文 チートシート そして最初の Word ドキュメントを WordToMD.