エディターからMarkdown ドキュメントを作成する id223MIE0B079

Markdownは、プレーンテキストドキュメントに書式要素を追加するのに役立つ、軽量なマークアップ言語です。 Adobe Experience Manager Guidesには、エディターからMarkdown \(.md\)トピックを作成、作成、プレビューする機能が用意されています。 既存のMarkdown ドキュメントをアップロードして、エディターで編集することもできます。

Markdown トピックの作成

エディターからMarkdown トピックを作成するには、次の手順を実行します。

  1. リポジトリーパネルで「 」を選択し、ドロップダウンから「トピック」を選択します。

  2. 新しいトピック ダイアログボックスで、次の詳細を入力します。

    {width="300"}

    • タイトル:トピックのタイトルを指定します。
    • 名前: トピック タイトルに基づいてファイル名が自動的に提案されます。 管理者がUUID設定に基づいて自動ファイル名を有効にしている場合、「名前」フィールドは表示されません。
    • テンプレート: ドロップダウンリストから​ Markdown ​を選択します。 テンプレート トピック​はデフォルトで選択されています。
    • パス: トピックファイルを保存するパスを参照します。 デフォルトでは、リポジトリで現在選択されているフォルダーのパスが「パス」フィールドに表示されます。
    note
    NOTE
    アップグレードの場合は、使用中の現在のフォルダープロファイルにMarkdown テンプレートを追加する必要があります。 エディター🔗から新しいマークダウン テンプレートを作成するか、既存のテンプレートをマークダウン オーサリングに使用できます。 Experience Manager Guidesでオーサリングテンプレートを追加する方法について詳しくは、​ グローバルレベルまたはフォルダーレベルのプロファイルの設定を参照してください。
  3. 作成」を選択します。

    選択したパスにMarkdown トピックが作成され、編集用に開かれます。

    {width="650"}

NOTE
リポジトリパネル内で、フォルダーのマークダウントピックを作成することもできます。 マークダウン トピックを作成するフォルダーを選択し、新規​を選択してから、オプション メニューから​ トピック ​を選択します。 トピックを作成 ダイアログボックスでトピックの詳細を指定して、マークダウン トピックを作成できるようになりました。

Markdown トピックのエディター機能について

この節では、Markdown トピックのオーサリング用エディターで使用できるさまざまな機能について説明します。 オーサリングインターフェイスは、次のセクションまたは領域に分かれています。

ツールバー

ツールバーはタブバーのすぐ下にあります。 ツールバーで使用できる機能は、次のように説明されます。

機能
説明
アクションの編集
カット 取り消し やり直し コピー 削除 検索と置換 など、様々なドキュメント編集機能にアクセスできます。 使用可能なオプションには、メニュー ドロップダウンからアクセスできます。
テキストの書式設定オプション
見出し 太字 斜体 取り消し線 コード 引用ブロック など、様々なテキスト書式設定オプションにアクセスできます。
コンテンツ挿入オプション
番号付きリスト 番号付きリスト 画像 相互参照 および​シンボル を文書に挿入するオプションを提供します。

メモ:画像やその他のファイルをMarkdown エディターにドラッグ&ドロップすることもできます。 ファイルは相互参照リンクとして追加され、画像は標準の画像要素として表示されます。
バージョン履歴
マークダウンファイルのバージョンを作成し、変更履歴を表示できます。 異なるバージョンを比較し、必要に応じて以前のバージョンに戻すことができます。 バージョン履歴オプションは、メニュー ドロップダウンにあります。
新しいバージョンとして保存
トピックで行われた変更を保存し、トピックの新しいバージョンを作成します。 新しく作成したトピックに取り組んでいる場合、バージョン情報は「なし」と表示されます。
ロック/ロック解除
現在のファイルをロックまたはロック解除します。 ファイルをロックすると、ファイルへの排他的な書き込みアクセス権が付与されます。 これにより、他のユーザーによるファイルの編集が制限されます。 他のユーザーに編集アクセス権を付与する場合は、ファイルのロックを解除します。 管理者は、他のユーザーがロックしたファイルのロックを解除できる​ 強制ロック解除 ​機能にもアクセスできます。
NOTE
バージョン履歴​機能と、編集操作、テキスト書式設定、コンテンツ挿入に記載されている機能は、マークダウン トピックの​ Source ​と​ 並べて ​表示の両方からアクセスできます。

コンテンツ編集エリア

コンテンツ編集領域には、トピックのMarkdown ソースが表示され、すべてのコンテンツを編集できます。 横に並べて表示すると、この領域は左側のMarkdown ソースビューと右側のプレビューの2つのセクションに分割されます。 複数のトピックを同時に開くことができ、それぞれのタブに表示されます。

Source、並べ替え、プレビューモード

Markdown オーサリングの場合、エディターは、コンテンツの作成と書式設定を支援する3つの異なる表示モードをサポートしています。

  • ソース
  • 並べて表示
  • プレビュー

ソース

これはエディターのマークダウンコードビューです。 通常のマークダウンエディターと同様に、マークダウンのトピックを編集できます。 Source ビューには、文書のリビジョンの保存、見出しの挿入、表の挿入、画像の挿入などのオプションがあります。

このビューは、レンダリングされた出力を表示せずに生のマークダウンの書き込みと編集のみに焦点を当てる場合に使用します。

並べて

このモードでは、エディターを2つのパネルに分割します。

  • 編集中のマークダウントピックを表示するSource パネル。
  • Markdown トピックのレンダリング出力をリアルタイムで表示するプレビューパネル。

{width="550"}

このビューは、マークダウンのトピックを編集する際に、レンダリングされた出力をリアルタイムで表示する場合に使用します。

プレビュー

プレビューモードでマークダウントピックを開くと、ユーザーがブラウザーでトピックを表示したときに、そのトピックがどのように表示されるかを示します。 このビューでは、すべての編集機能がツールバーから削除されます。 ただし、ツールバーの​新しいバージョンとして保存ロック/ロック解除​機能、右側のパネルの​ ファイルプロパティ ​機能には、引き続きアクセスできます。

右側のパネル

右側のパネルでは、**ファイルプロパティパネルにアクセスできます。

ファイルのプロパティには、次の2つのセクションがあります。

一般

「一般」セクションでは、次の機能にアクセスできます。

  • ファイル名:選択したトピックのファイル名を表示します。
  • ID:選択したトピックのIDを表示します。
  • 言語: トピックの言語を表示します。 プロパティページの「言語」フィールドから設定します。
  • 作成日: トピックが作成された日時を表示します。
  • 変更日: トピックが変更された日時を表示します。
  • によってロックされています: トピックをチェックアウトしたユーザーを表示します。
  • ドキュメントの状態:現在開いているトピックのドキュメントの状態を選択して更新できます。 詳細については、​ ドキュメントの状態を参照してください。
  • タグ:トピックのメタデータタグです。 これらは、プロパティページの「タグ」フィールドから設定します。 ドロップダウンから入力または選択できます。 タグはドロップダウンの下に表示されます。 タグを削除するには、タグの横にある十字アイコンを選択します。
  • 他のプロパティを編集: ファイルのプロパティ ページから、他のプロパティを編集できます。

参照

「参照」セクションでは、次の機能にアクセスできます。

  • で使用:現在のファイルが参照または使用されているドキュメントは、「参照で使用」リストに表示されます。
  • 送信リンク:送信リンクには、現在のドキュメントで参照されているドキュメントが一覧表示されます。
NOTE
すべての使用済みリンクと送信リンクの参照は、文書にハイパーリンクされています。 リンクされたドキュメントを簡単に開いて編集できます。

機能の制限

以下のExperience Manager Guides機能は、現在、Markdown オーサリングには適用されません。

  1. レビュー
  2. 結合
  3. AI アシスタント
  4. 変更をトラック

親トピック:​ エディターの概要

recommendation-more-help
experience-manager-guides-help-product-guide