> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Markdown 使い方ガイド
> Markdownは、著名な独立系ブロガーのジョン・グルーバー（John Gruber）氏が考案した軽量な執筆言語です。シンプルな記号構文で、執筆と同時にレイアウトを完成できます。文章の内容に集中でき、よりスムーズに、より没入感を持って執筆でき、作業効率が向上します。
## Markdownとは？
Markdownは、著名な独立系ブロガーのジョン・グルーバー（John Gruber）氏が考案した軽量な執筆言語です。シンプルな記号構文で、執筆と同時にレイアウトを完成できます。文章の内容に集中でき、よりスムーズに、より没入感を持って執筆でき、作業効率が向上します。
## なぜMarkdownを使うのか？
Markdownで執筆する際に構文記号を入力すると、エディタが自動的にレイアウトを整えてくれます。このメリットは、文章を書き終えると同時にレイアウトも完成しており、メニューバーで文字記号や太字などを調整する必要がなく、執筆効率が向上することです。
## Markdownのメリット
**構文がシンプル**
**互換性が高い**
**コンテンツに集中**
* 構文がシンプル：Markdownの構文は、シンプルでよく使われるマーキング記号です。プログラマーでなくても、誰でも数分で習得できます。
* 互換性が高い：どのエディタで開いても、フォーマットが崩れません。
* コンテンツに集中：Markdownで執筆すれば、レイアウトに悩む必要はなくなり、簡潔でエレガントなフォーマットにより、両手をキーボードから離すことなく、執筆の楽しさに没入できます。
## DingTalkドキュメント Markdownのアップグレードハイライト
### サポート範囲
* **太字**/**斜体**/**取り消し線**/**下線**/**上付き・下付き文字**/ハイライトテキストなど、多様なテキストスタイルを完全サポート
* Katex数式の入力をサポート。インラインスタイル **$a+b$**、ブロックレベルスタイル **$a+b$** に対応
* ハイライトブロック構文をサポート
* **画像**、リンク構文をサポート
* **emoji**構文をサポート
* **\`\`\`mermaid** + **Enter** によるテキスト作図の挿入をサポート
* スプレッドシート構文をサポート
* 貼り付け時のリッチテキスト変換でMarkdownへのHTML埋め込みをサポート
#### ディテール最適化
* ハイライトブロックの色を複数内蔵し、`::: + ` で素早く指定可能
* 入力アシスト機能を追加し、多数のコードブロック構文、**ハイライトブロックタイプ**、emojiコードを覚える必要がなくなりました
* 使いやすいリンクのMarkdown入力方法：
* **\[]\()** でリンクのプレースホルダーを入力し、自動でタイトル入力欄にフォーカス
* **\[title]\()** でリンクを入力し、自動でリンクアドレス入力欄にフォーカスして入力完了
* スプレッドシート **| | |** + **Enter** で2行2列のスプレッドシートが挿入され、先頭行の先頭列にフォーカス。**|x| |** + **Enter** のように入力すると2行目の先頭列にフォーカス
* 貼り付け時には、必要に応じて「リッチテキストに変換」オプションが表示され、MarkdownテキストをDingTalkドキュメントがサポートする形式に変換可能
## Markdown使い方の宝典
DingTalkドキュメントは大部分のMarkdown構文をサポートしています。「**インポート**」「**エクスポート**」「**貼り付け**」「**編集**」時にMarkdown構文を使用できます。
| 一般的なMarkdown構文 | 高度なMarkdown構文 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \* **見出し 1-6**
\* **参照**
\* **リスト**：番号付きリスト、箇条書き、タスクリストなど
\* **コードブロック**
\* **インラインコード**
\* **区切り線**
\* **テキスト書式**：太字、斜体、下線、取り消し線、背景色、上付き・下付き文字など | \* **リンク**
\* **画像**
\* **数式**
\* **ハイライトブロック**
\* **スプレッドシート**
\* **Emoji**
\* **テキスト作図** |
### インポート
ドキュメント作成時に「オンラインドキュメントとしてインポート」-「ローカルドキュメント」を選択し、ローカルの.mdファイルを選択すると、DingTalkドキュメントとしてインポートできます。
### エクスポート
編集完了後、mdファイルとしてダウンロードを選択し、エクスポートを完了できます。現在エクスポート時にサポートされるMarkdown形式：《⏬ Markdownとしてエクスポート》
### 貼り付け
プレーンテキストエディタまたはMarkdownエディタからMarkdownテキストをコピーし、DingTalkドキュメントに貼り付けます。表示される貼り付けオプションで「リッチテキストに変換」をクリックすると、DingTalkドキュメントがサポートするリッチテキスト形式に変換されます。貼り付け時にサポートされるMarkdown形式：《 Markdownテキストを貼り付け》
### 編集
特定のMarkdown形式のテキストを入力し、対応するトリガーキー（スペースまたはEnter）を入力すると、テキストが対応する形式に変換されます。編集時にサポートされるMarkdown形式は《⌨️ Markdown編集》をご参照ください。
DingTalkドキュメントで添付ファイル《edit markdown.mp4》をご覧ください。
## Markdown よく使う編集構文一覧
| **機能** | | **Markdown編集** | **効果** |
| ------------- | ------------------ | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **書式** | **太字** | \*\*text\*\* + Space
\_\_text\_\_ + Space | **太字** |
| | **斜体** | \*text\* + Space
\_text\_ + Space | *斜体* |
| | **取り消し線** | ~~text~~ + Space | ~~取り消し線~~ |
| | **下線** | text + Space | 下線 |
| | **上付き文字** | ^text^ + Space | ^上付き文字^ |
| | **下付き文字** | ~~text~~ + Space | ~~下付き文字~~ |
| | **テキストハイライト** | ==text== + Space | ==テキストハイライト== |
| | **インラインコード** | \`text\` + Space | `インラインコード` |
| **見出し** | **見出し 1** | # + Space | # 見出し1 |
| | **見出し 2** | ## + Space | ## 見出し2 |
| | **見出し 3** | ### + Space | ### 見出し3 |
| | **見出し 4** | #### + Space | #### 見出し4 |
| | **見出し 5** | ##### + Space | ##### 見出し5 |
| | **見出し 6** | ###### + Space | ###### 見出し6 |
| **コードブロック** | | \`\`\` + Enter
\`\`\`js + Enter | `text/x-sh
var a = 1;
` |
| **数式** | **インライン数式** | $text$ + Space | abc$a+b$ |
| | **ブロックレベル数式** | $text$ + Space | abc
$a+b$ |
| **リスト** | **番号付きリスト** | 1. + Space
a. + Space | 1. リスト
1. リスト |
| | **箇条書き** | \* + Space
- + Space | \* リスト
\* リスト |
| | **タスクリスト** | \[] + Space
\[x] + Space | \* \[ ] タスクリスト
\* \[x] タスクリスト |
| **参照** | | > + Space | > 参照 |
| **リンク** | | \[]\() + Space
\[abc]\() + Space
\[abc]\([http://foo](http://foo)) + Space | Webリンクを追加
abc
[abc](https://foo) |
| **画像** | | !\[]\() + Space
!\[]\([http://foo/bar](http://foo/bar)) + Space | DingTalkドキュメントで「画像」をアップロードしてください |
| **ハイライトブロック** | **デフォルトハイライトブロック** | ::: + Enter | :::
デフォルト効果
::: |
| | **危険ハイライトブロック** | :::danger + Enter | |
| | **警告ハイライトブロック** | :::warning + Enter | |
| | **情報ハイライトブロック** | :::info + Enter | |
| | **成功ハイライトブロック** | :::success + Enter | |
| | **お知らせハイライトブロック** | :::tips + Enter | |
| **Emoji** | | :smile: + Space | |
| **スプレッドシート** | | \|a\|b\| + Enter | |
| **区切り線** | | \*\*\* + Enter
--- + Enter | --- |
| **テキスト作図** | | \`\`\`mermaid + Enter | `mermaid
graph TD
A[Christmas] -->\|Get money\| B(Go shopping)
B --> C\{Let me think\}
C -->\|One\| D[Laptop]
C -->\|Two\| E[iPhone]
C -->\|Three\| F[fa:fa-car Car]
` |
## DingTalkドキュメント特色のMarkdown活用法のおすすめ
### ハイライトブロックのショートカット入力
コロン3つ（全角・半角どちらも対応）+ Enterで、ハイライトブロックを入力できます
コロンの後にタイプを付けると、色を素早く設定できます～
### emoji、ハイライトブロック、コードブロックの入力アシスト
スマートな入力アシストにより、煩雑なエンコードタイプを覚えなくても、以下が入力できます：
* サポートされているemojiコード
* ハイライトブロックタイプ
* コードブロック構文
DingTalkドキュメントで添付ファイル《辅助输入.mov》をご覧ください。
### リンクの別の入力方法
一般的な `[title](url)` の書き方をサポートしています
DingTalkドキュメントで添付ファイル《屏幕录制2022-09-06 下午5.45.34.mov》をご覧ください。
### テキスト作図のショートカット入力
\`\`\`mermaid + Enter
コードブロックを入力するようにテキスト作図を追加できます～
DingTalkドキュメントで添付ファイル《屏幕录制2022-09-28 上午11.35.08.mov》をご覧ください。