Markzen ヘルプ

ヘルプ

Markzenとは?

Markzenは、軽量マークアップ言語(Markdownとその他6つ)用のデスクトップエディターで、ライブで完全にスタイル設定されたプレビューを備えています。左側でシンプルな句読点を使ってマークアップされたプレーンテキストを記述すると、Markzenは入力と同時にそれをフォーマットされたHTMLとして右側にレンダリングします。

一般的なMarkdownエディターと異なるのは、ラウンドトリップです。Markzenは8つのマークアップ言語を読み込み、30のライブ拡張機能(図、グラフ、数式、楽譜、チェス盤、QRコード)をドキュメント内にレンダリングし、20以上の形式(電子書籍、Word、PowerPoint、LaTeX、Jupyterノートブックなど)にエクスポートします。一度書けば、その結果をほとんどあらゆるものとして渡すことができます。コンバーターは内蔵されているため、外部ツールをインストールする必要はありません。

既存のファイルを開くことも、すぐにタイピングを開始することもできます。最初にファイルを開く必要はありません。

エディター

左ペインは単なるプレーンテキストボックスではなく、完全なCodeMirrorコードエディターです。記述しているマークアップの構文ハイライト、書式設定ツールバー(太字、斜体、見出し、リストなど、さらにリンクと画像を挿入するための専用ボタン — *リンクと画像*を参照 — およびテーブルを挿入するためのボタン — *テーブルとスプレッドシート*を参照)、検索と置換機能があります。コピー、貼り付け、元に戻す、やり直しなどの標準的な編集ショートカットは期待どおりに機能します。

8つの軽量マークアップ言語のいずれかで記述します。これらは、隠れたスタイルではなく句読点(見出しには#、強調には*)で構造を表現するプレーンテキスト形式であるため、ドキュメントはテキストとして読みやすく、バージョン管理で差分を比較しやすいです。Markzenは8つすべてを読み取り、ファイルの拡張子によってどの言語であるかを判断します。手動で形式を選択することはありません。*互換性*は、どの拡張子がどの言語を開くかを示しています。

各言語には独自の慣習と既存のドキュメントエコシステムがあります。Markzenは、すべてを最初にMarkdownに変換するのではなく、それぞれを独自のダイアレクトでレンダリングします。BBCodeは単一の標準がない言語であり、すべてのフォーラムが独自のバリアントを発明したため、Markzenはそれを寛大に読み取り、一般的な表記を並べて受け入れ([list]または[ul][h1]または[heading=1])、認識しないタグは飲み込まずにプレーンテキストとして表示します。ドキュメントが記述されているマークアップの種類を切り替えるには、ツールバーの変換先メニューを使用します(以下の変換とエクスポートを参照)。

**すべての言語がすべてを表現できるわけではありません。*書式設定ツールバーはすべてのドキュメントで同じボタンを表示しますが、Markzenは言語自体が定義するマークアップのみを記述し、ギャップを埋めるために独自のダイアレクトを発明することはありません。現在の言語に表記がないボタンはグレー表示されます。太字、斜体、見出し、リスト、コードブロック、リンク、画像、罫線、テーブルは8つすべてで利用可能です。いくつかのギャップは互換性*に記載されています。Markdownのものは人々を驚かせます。段落を中央揃えにする標準的な方法がないため、Markzenは、一部の読者しか認識しないものを記述するのではなく、そこに配置ボタンを提供しません。

テキストサイズは、ツールバーの文字を大きくおよび文字を小さくボタンで設定します。エディターペインは完全に非表示にすることもできます。非表示にすると、Markzenは純粋なリーダーになります(ライブプレビューを参照)。

書式設定ツールバーには、ドキュメントにリンクまたは画像を挿入するための専用ボタンが2つあり、それぞれカーソルのある場所に小さなポップアップを開きます。リンク (Ctrl+K) — または Ctrl+K を押す — はハイパーリンクを挿入します。リンクテキストとそのアドレスを入力すると、Markzen が正しいマークアップを記述します。画像 は同じ方法で画像を挿入しますが、以下で説明するいくつかの追加の選択肢があります。

どちらも現在のドキュメントが使用するマークアップで記述されます。AsciiDocファイルに挿入されたリンクはAsciiDocとして、Orgファイルに挿入されたリンクはOrgとして、といった具合に、8つの言語すべてで同様に機能します。

既にあるアドレスから開始する。 Webアドレスをドキュメントに貼り付け、それを選択して Ctrl+K を押します。Markzen は、選択が単語ではなくアドレスであることを認識し、ポップアップのアドレスフィールドにそれを配置し、空のテキストフィールドにカーソルを残して、リンクが何と表示されるべきかを待ちます。これがないと、選択されたアドレスはリンクの表示テキスト — ベアURLとして読み取られるリンク — になってしまいます。絶対ファイルパスもWindowsなどでアドレスとしてカウントされるため、同じショートカットで貼り付けたパスをそのファイルへのリンクに変換できます。

既にあるリンクや画像を編集する。 既存のリンクや画像の上にカーソルを置き、ポップアップを再度開きます(ボタン、または Ctrl+K)。Markzen はその構造を認識し、現在のテキストとアドレスをポップアップに読み込み、確認すると全体を置き換えます。これにより、誤って新しいリンクを古いリンクの中にネストするのではなく、その場で編集できます。

画像の場合、ポップアップにはパスを入力する代わりにディスクからファイルを選択するための 画像を参照 ボタンも表示されます。これは、最後に画像を取り込んだフォルダーで開きます(ドキュメントの元となるフォルダーとは別に保持されます)。そして、画像が埋め込みかリンクかという重要な選択肢があります。

埋め込み画像またはリンク画像

画像を挿入すると、Markzen はそれをドキュメントに2つの方法で保存できます。

  • リンク済み — ドキュメントはファイルパスまたはWebアドレスによって画像を指すだけです。ドキュメントファイルは小さく保たれますが、画像はドキュメントと一緒に移動するか(またはURLで到達可能である必要があります)、そうしないと他の場所に表示されません。これがデフォルトです。
  • 埋め込み — 画像の実際のバイトがテキストとしてドキュメントに書き込まれます(base64 data: ブロック)。そのため、ファイルは完全に自己完結型です。1つのファイルがすべてを運び、追跡を失うものはありません。トレードオフはサイズです。ドキュメントは画像の重さだけ増加し、埋め込み画像は相対パスを使用できません。

単一のポータブルファイルを渡したい場合は埋め込みを選択し、画像をドキュメントの横に保持し、ファイルを小さく保ちたい場合はリンクを選択します。

リンク画像の場合、もう1つのオプションが表示されます。相対パス です。画像がドキュメント自身のフォルダー(またはサブフォルダー)にある場合、これをチェックすると、完全な絶対パスではなく短い相対パスとして参照が書き込まれるため、ドキュメントとその画像を一緒に移動してもリンクは機能し続けます。これは、画像がドキュメントのフォルダー内にある場合にのみ提供されます。それ以外の場合、書き込む相対パスはありません。

埋め込み画像はエディターで整理された状態を保ちます。 base64で埋め込まれた画像は、そうでなければ周囲の行を埋め尽くす長いテキストの壁になるため、Markzen はそれぞれをタイプとサイズを示す小さなチップに折りたたみます(例:🖼 webp · 38 KB)。チップは表示専用です。基になるテキストは手つかずのままであるため、保存、コピー、または切り取りは常に完全な画像を運び、カーソルはチップを単一の単位としてスキップします。

ファイル、タブ、保存

Markzenは、好きなだけ多くのドキュメントを一度に開いておくことができ、それぞれが独自のタブに表示されるため、複数のファイルをまたいで作業し、自由に切り替えることができます。ファイルを開かなくても作業を開始できます。既にある空白のドキュメントに直接入力するか、ツールバーのファイルボタンを使用します。

  • 新規ドキュメント — 8つのマークアップ言語をリストした短いメニュー(新規作成)を開きます。そのマークアップで書かれた新しい空のドキュメントを新しいタブで開始するために1つを選択します。
  • Markdown ファイルを開く — 既存のファイルをブラウズして開きます。ピッカーは8つのマークアップ形式すべてを受け入れ、Markzenはファイルの拡張子から適切なものを選択します。最後にドキュメントを取り出したフォルダーで開かれ、セッション間で記憶されるため、毎回最初から始める必要はありません。
  • 保存 — アクティブなドキュメントをファイルに書き戻します。一度も保存されていないドキュメントは、最初に名前を付けられるように「名前を付けて保存」にフォールバックします。
  • 名前を付けて保存 — アクティブなドキュメントを新しいファイルに保存し、元のファイルはそのまま残します。

また、ファイルマネージャーからファイルをドラッグしてウィンドウにドロップして開くこともできます。

開いている各ドキュメントは、ウィンドウの上部にあるタブです。保存されていないタブには点が付き、マークアップがMarkdownではないタブには小さな形式バッジ(例:adoc)が表示されます。タブの**×はタブを閉じます。保存されていない変更があるドキュメントを閉じても、それらが黙って破棄されることはありません。インラインバーがタブに表示され、最初に保存または破棄**を選択できます。

ドキュメントが開いている間、Markzenはディスク上のファイルを監視します。ファイルが別のプログラムで変更され、あなた自身の未保存の編集がない場合、Markzenは新しいバージョンを自動的に取り込みます。未保存の編集がある場合は、最初に確認します。インラインの再読み込みバーで、ディスク上のバージョンを採用するか、自分のバージョンを保持するかを決定できます。

ライブプレビュー

右側のペインは、入力中にライブで更新される、スタイル設定されたHTMLとしてレンダリングされたドキュメントです。リンクは機能し、テーブルは整列し、コードは等幅ブロックで表示され、タスクリストにはチェックボックスが付き、すべてのレンダリング拡張ブロック(下記参照)はその図を所定の位置に描画します。プレビューは、HTMLまたはPDFエクスポートがどのように見えるかの忠実な画像です。

MarkdownドキュメントがYAMLフロントマターブロック(Jekyll、Hugo、Obsidianなどのツールが一番上に配置する--- key: value ---セクション)で始まる場合、Markzenは、閉じ---が迷子の見出しになるのを防ぎ、ドキュメントの上にきちんとしたメタデータカードとしてレンダリングします。

レイアウトモード

3つのツールバーボタンのグループが、ウィンドウに表示される内容を設定します。

  • 分割ビュー — エディターとプレビューを並べて表示します。区切り線をドラッグして、それぞれのスペースの量を変更します。
  • エディタを表示 — エディターのみで、ウィンドウ全体を埋めて集中して執筆できます。
  • プレビューを表示 — プレビューのみで、クリーンな全幅リーダーです。

目次

目次ボタンは、ドキュメント内のすべての見出し(######など)から自動的に構築されたパネルを開きます。任意のエントリをクリックすると、プレビューがそのセクションにスクロールします。サブ見出しを持つ見出しにはシェブロンが表示されます。クリックすると、そのセクションを折りたたむしてネストされた見出しを非表示にするか、展開して元に戻すことができます。これにより、長いアウトラインを現在作業中の部分だけに折りたたむことができます。パネルヘッダーの小さな2 / 3 / 4ボタンは、アウトラインを見出しの深さに制限します。これは、長いドキュメントで最上位レベルのみを表示したい場合に便利です。アクティブなボタンをもう一度クリックすると、すべてのレベルが元に戻ります。パネルは左端をドラッグしてサイズ変更でき、折りたたむと読み取りスペースが解放されます。これはアプリ内でのみナビゲーション補助として機能し、エクスポートには表示されません。

独自の目次を提供する。 見出しが目的のアウトラインでない場合、ドキュメントは独自の目次を持つことができます。最初の行がtocであるmarkzenタグ付きのフェンスブロックは、生成されたパネルをその下に書かれたリストに置き換えます。

`markdown

```markzen
toc
- [Introduction](#intro)
  - [Background](#background)
- [Results](#results)
```

インデントがレベルを設定し、すべてのエントリはドキュメント自体に存在する必要があるアンカー(明示的なidを付けた見出し、またはプレーンな<a id="intro"></a>)を指します。ブロック自体は何も描画しません。パネルが読み取るメタデータです。

表とスプレッドシート

表はMarkzenとあらゆるスプレッドシートの間でクリーンに移動します。Excel、Google Sheets、Word、またはWebテーブルからコピーしたタブ区切りのテキストをエディターに貼り付けると、Markzenはそれをタブ文字の羅列ではなく、ドキュメント自身のマークアップで書かれた適切な表に変換します。貼り付けリーダーは引用符を認識し(タブ、改行、引用符自体を含むセルを正しく処理します)、クリップボードに少なくとも2列のきれいな長方形グリッドがある場合にのみトリガーされます。それ以外は通常のテキストとして貼り付けられます。

表を最初から作成することもできます。ツールバーのテーブルを挿入ボタンをクリックすると小さなグリッドが開き、そこをなぞって必要な行と列の数を選択すると、Markzenはそのサイズの空の表をドキュメント自身のマークアップで書き込み、入力準備が整います。最初の行はヘッダー行です。

逆もまた可能です。プレビューでレンダリングされた表にカーソルを合わせると、その隅にコピーボタンが表示されます。これは表をタブ区切りのテキストとしてコピーし、スプレッドシートのセルやWordドキュメントに直接貼り付けることができます。これらのコピーボタンはプレビューの便宜のためだけであり、すべてのエクスポートと変換から削除されるため、共有ファイルにはクリーンな表のみが含まれます。

レンダリング拡張機能

Markzen は、フェンスで囲まれたコードブロックを通じて標準マークアップを拡張します。開始のトリプルバックティックの直後にある言語タグは、ブロックのレンダリング方法を決定します。Markzen が拡張機能として認識するタグは、コードを表示する代わりにライブ図形を描画します。

各種類の図形は独自のレンダリングエンジンによって描画され、Markzen は起動時にすべてのエンジンをロードするのではなく、ドキュメントが実際に要求したときに初めてエンジンを取得します。そのため、アプリはほぼ瞬時に起動し、特定の種類の最初の図が表示されるまでに時間がかかることがありますが、それ以降の図はすべて即座に表示されます。

たとえば、このソースは次のようになります。

```mermaid
graph LR
  A --> B --> C
```

コードリストではなく、ライブフローチャートとしてレンダリングされます。PDF および HTML エクスポートでもフローチャートのままです。

図、グラフ、数学、楽譜、チェス盤、囲碁盤、QR コードなどが組み込まれています。互換性 には、それぞれのタグがリストされています。

各拡張機能には独自の言語タグ (mermaidchartjskatexabcchess など) があります。1つのドキュメントで通常の散文と好きなだけ混ぜて使用できます。それらはすべて一緒にレンダリングされます。ドキュメントが Markzen を離れた後も図形が図形として残るかどうかは、どこに送信するかによって異なります。以下の 変換とエクスポート を参照してください。

文中の数式

数式は、教科書の数式のように単独で中央に配置された独自のブロック (katex または asciimath ブロック) にすることができます。これは、8つのマークアップ言語すべてで機能します。

数式は文中に配置することもできるため、「面積は円周率 r の二乗」は、実際の記号を含む1行の散文として読み取れます。これは、マークアップ言語にそのための表記法があるかどうかに依存し、それぞれが異なる方法で記述します。言語ごとの表記法は 互換性 にあります。

Textile と BBCode は2つの例外であり、これは Markzen の制限ではなく、これらの言語の制限です。どちらも数学を記述する方法を定義していません。したがって、Textile または BBCode ドキュメントでは、数式は独自のブロックである必要があります。何も失われることはありません。数式はレンダリングされ、エクスポート後も残ります。単に散文の行に織り込むことができないだけです。

図形の配置とサイズ変更

プレビューでレンダリングされた図形にカーソルを合わせると、その横に小さなパネルが表示されます。配置 ボタン (左、中央、右) と、サイズ変更可能な種類の図形の場合は、ピクセル単位の および 高さ ボックスが表示されます。remove style block でそれらを再度クリアします。

その選択はどこか見えない場所に保存されるわけではありません。パネルはそれをドキュメントに書き込み、適用される図形の直前に配置された markzen タグ付きの短いブロックとして書き込みます。

```markzen
style
align center
width 480
```

したがって、レイアウトはファイルと一緒に移動します。これは、どのマシンでも保存、引き渡し、エクスポートする内容の一部です。ブロックを手動で記述することもできます。1行に1つのディレクティブ、align (leftcenter、または right)、ピクセル単位の widthheight で、常にその直下のブロックに適用されます。

CSS で1つのドキュメントをスタイル設定する

Markdown ドキュメントは、style タグ付きのフェンスで囲まれたブロックに独自のスタイルシートを含めることもできます。

```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```

このルールは、そのドキュメントのプレビューと PDF および HTML エクスポートに、アクティブなスタイルテンプレートの上に適用されます。これは、他のすべての設定を変更することなく、1つのドキュメントに独自のルックアンドフィールを与える方法です。通常のセレクターのみがサポートされます。@media@keyframes などのアットルールはサポートされておらず、このブロックは Markdown ドキュメントでのみ機能します。

変換とエクスポート

ツールバーの変換先メニューは、完成したドキュメントがMarkzenから離れる場所です。ここでは2つの異なる機能があります。

別のマークアップ言語に変換する。 軽量マークアップの下で、開いているドキュメントを他の7つのマークアップ(AsciiDoc、BBCode、Djot、MediaWiki、Org、reStructuredText、Textile)のいずれかに書き換えます。これは、WikiがMediaWikiを要求する場合、フォーラムがBBCodeを要求する場合、出版社がAsciiDocを要求する場合、またはエコシステム間でメモを移動する場合に便利です。8つのマークアップ言語はそれぞれメニューに一度表示されます。ここからMediaWikiとして保存されたドキュメントは、他の場所で取得するファイルと同じです。

完成した形式にエクスポートする。 ドキュメントをバンドルされたコンバーターに渡し、20以上のドキュメント形式を出力します。これらは用途別にグループ化されています。

カテゴリ 形式
電子書籍 EPUB 3、FictionBook2
ワープロ Microsoft Word (.docx)、OpenDocument (.odt)、Rich Text Format (.rtf)
プレゼンテーション Microsoft PowerPoint (.pptx)、reveal.js (.html)
組版 InDesign ICML、LaTeX (.tex)、Typst (.typ)
XML DocBook、JATS、OpenDocument XML、TEI Simple
ノートブック Jupyter Notebook (.ipynb)
アウトライン OPML (.opml)

コンバーターはMarkzen内に同梱されており、追加のダウンロードや設定は不要です。これらに加えて、3つのクイック出力がツールバーにあります。PDFとして保存HTMLとして保存は、レンダリングされたドキュメントをプレビューどおりに(スタイルテンプレート、フォント、拡張図を含めて)エクスポートし、印刷はプリンターに送信します。コードフォントはエクスポートされたファイルに移動するため、コードブロックやASCII図は、読者のマシンにそのフォントがインストールされているかどうかにかかわらず、あなたが見た通りの見た目で表示されます。

何が移動し、何が移動しないか。 レンダリング拡張図は、ターゲット形式が画像を保持できる場合にのみ図として残るため、ドキュメントはMarkzenを次の2つの経路のいずれかで離れます。

  • あなたが見るドキュメントとして — 上記の3つのツールバー出力(PDF、HTML、印刷)と、上記の表にある5つの形式:EPUB 3、Microsoft Word (.docx)、OpenDocument (.odt)、Microsoft PowerPoint (.pptx)、Rich Text Format (.rtf)。図、数式、楽譜は画像として書き出され、そのままの状態です。
  • ドキュメントのソーステキストとして — 他のすべてのターゲット、および他のマークアップ言語へのすべての変換。散文、見出し、リスト、表、リンクはすべて変換されます。mermaidまたはkatexブロックは、Markzenがそれらを渡すための図がないため、入力したソースを保持する通常のコードブロックとして到着します。

したがって、図を中心に構築されたドキュメントは、PDF、HTML、EPUB、Word、OpenDocument、PowerPoint、またはRTFとして渡すのが最適です。LaTeX、Typst、reveal.js、その他は、各図のソースがそのまま残され、そのエコシステム独自のツールで利用できるよう、ドキュメント全体を提供します。

コマンドラインからのエクスポート

Markzen はウィンドウを開かずに動作させることもできます。Markzen 実行ファイルにソースファイルと出力パスを指定する -o オプションを渡すと、ドキュメントをレンダリングし、エクスポートを直接ディスクに書き込みます。

markzen.exe report.md -o report.pdf

ソースは Markzen が読み取れる8つのマークアップ形式のいずれかです。出力はPDFまたはHTMLファイルで、出力名の拡張子によって選択されます。エクスポートはアプリ自体と同じレンダリングプロセスを経るため、図、数式、その他のすべての拡張ブロックはライブの図として出力されます。エクスポートにはデフォルトのスタイルテンプレートとフォントが使用されます。コマンドラインはアプリとは別の独自のクリーンなプロファイルで実行されるため、Markzen がすでに開いている間でも問題なく動作します。

複数のドキュメントを1回の呼び出しでエクスポートできます。任意の数の source -o output ペアを指定すると、1回の起動ですべてがレンダリングされ、ファイルごとに1回起動するよりもはるかに少ないコストで済みます。

markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf

フォントと外観

Markzen は、ドキュメントを一般的なものではなく、組版されたように見せるために構築されています。そのためのコントロールは、ツールバースタイルとフォントボタンの背後にまとめられているため、読みながら調整できます。テーマとインターフェース言語は、設定 → 表示にあります。

スタイルテンプレート

スタイルは、標準GitHub書籍モダンミニマルの5つのプレビュースタイルを提供します。選択したテンプレートは、PDFおよびHTMLエクスポートにも適用されるスタイルであり、共有ドキュメントの読み方を決定します。手渡すものには書籍またはモダンを、集中して読みたい場合はミニマルを選択してください。テンプレートはプレビューのみをスタイル設定し、エディターには適用されません。

フォント

同じパネルにある3つのピッカーは、テキストの種類ごとに異なるフォントを設定します。見出し本文コードがそれであり、これによりMarkzenドキュメントは組版されたように感じられます。

  • 見出し — Oswald、Playfair Display、Merriweather、Raleway、Montserrat、Lora、Libre Baskerville、Bebas Neue、Abril Fatface、Cinzel。
  • 本文 — Inter、Roboto、Georgia、Lato、Source Serif 4、Nunito、PT Serif、Crimson Text、Libre Franklin、Open Sans。
  • コード — JetBrains Mono、Source Code Pro、Cascadia Mono、Fira Mono。

コードフォントは、見た目以外の特性でも選ばれています。それらはすべて、ツリーリストやASCII図を構成するボックス描画文字│ ├ └ ─)を描画するため、コードブロックに貼り付けられたディレクトリツリーは、途切れることなくその形状を保ちます。また、これらは合字のないバリアントです。合字のあるフォントは!=を単一のとして再描画しますが、これはコードエディターでは快適でも、ファイルが実際に何を言っているかを示すことを意図したドキュメントでは不適切です。JetBrains MonoとSource Code ProはMarkzenに同梱されているため、それらを見たことがないマシンや、まったく接続がないマシンでも動作します。

テキストサイズ

ツールバーの文字を大きくおよび文字を小さくボタンは、テキストサイズを変更します。

テーマと言語

設定 → 表示で:

  • テーマライトまたはダーク。デフォルト:ライト。
  • 言語 — Markzenのインターフェースは、右から左に書くスクリプト(アラビア語、ヘブライ語)やCJK(中国語、日本語、韓国語)を含む50以上の言語に翻訳されています。

互換性

各マークアップ言語がサポートするもの、およびMarkzenが描画できるあらゆる種類のライブ図の参照テーブルです。ここにあるのはどこで何が機能するかについてであり、説明は上記のセクションにあります。

各マークアップ言語でできること

マークアップ言語 拡張子が次のファイルを開く ライブ図 目次パネル 文中の数式 表現できないもの
Markdown .md, .markdown すべて はい $…$ テキスト配置
AsciiDoc .adoc, .asciidoc, .asc styleを除くすべて はい ブロックのみ 取り消し線
reStructuredText .rst, .rest styleを除くすべて はい $…$ 取り消し線
Org .org styleを除くすべて はい $…$ 左揃えと右揃え
Textile .textile styleを除くすべて はい ブロックのみ
Djot .dj styleを除くすべて はい $`…`
MediaWiki .wiki, .mediawiki, .wikitext styleを除くすべて はい <math> インラインコード、取り消し線、引用ブロック、テキスト配置
BBCode .bbcode, .bb styleを除くすべて はい ブロックのみ

ライブ図styleブロックは唯一の例外です。これはドキュメント自体にCSSを適用し、Markdownのみがサポートしています。他のすべての種類の図は、すべての言語で機能します。BBCodeドキュメントでは、ブロックはバッククォートではなく[code=mermaid]…[/code]と記述され、MediaWikiでは<syntaxhighlight lang="mermaid">…</syntaxhighlight>と記述されます。

表現できないもの — これらはマークアップ言語自体の制限であり、Markzenの制限ではありません。言語に何かの表記法がない場合、Markzenは、それだけが読み取れるプライベートな方言を書くのではなく、そのためのボタンを提供しません。数式の行については、「文中の数式」を参照してください。

あらゆる種類の図

開始のトリプルバッククォートの後にタグを記述すると(```mermaid)、ブロックが図になります。

カテゴリ ブロックタグ 注記
ダイアグラム Mermaid mermaid フローチャート、シーケンス、クラス、ガント、ER、ステート
Graphviz graphviz DOT言語
Cytoscape cytoscape ネットワークグラフ。プレビューでパンとズームが可能
Markmap markmap 箇条書きのアウトラインからのマインドマップ。クリックで折りたたみ可能
Timeline timeline 垂直イベントタイムライン
ソフトウェアダイアグラム Nomnoml nomnoml UML
PlantUML plantuml UML — インターネット接続が必要な唯一の図
DBML dbml データベーススキーマダイアグラム
チャート Chart.js chartjs 棒グラフ、折れ線グラフ、円グラフ、レーダーチャート
Vega-Lite vega-lite JSONからの宣言型チャート
ECharts echarts 大規模なインタラクティブチャート
IT開発 Pseudocode pseudocode 組版アルゴリズム
Tabulator tabulator ソート可能なインタラクティブテーブル
Bytefield bytefield ビットおよびバイトフィールドレイアウト
QR Code qrcode
Railroad railroad 構文ダイアグラム
WaveDrom wavedrom デジタルタイミングダイアグラム
数学 KaTeX katex 文中の$…$も — 上の表を参照
AsciiMath asciimath プレーンテキストの数式表記
グラフ function-plot fnplot 関数曲線をプロット
JSXGraph jsxgraph インタラクティブジオメトリ
Plotly plotly 科学および3Dチャート
科学 SMILES smiles 化学構造ダイアグラム
音楽 ABC Notation abc プレーンテキストからの楽譜
VexFlow vexflow 彫刻された五線譜
VexChords vexchords ギターコードダイアグラム
ChordPro chordpro 歌詞の上のコード
MusicXML musicxml フルスコア
ゲーム Chess chess FENポジションからのボード
Go Board goboard 9×9、13×13、19×19
ドキュメント Markzen markzen 非表示: その下の図を配置およびサイズ変更するか、目次パネルを上書きします
Style style 非表示: このドキュメントのCSS — Markdownのみ

ファイルの関連付け

Windowsでは、インストーラーはMarkzenを、*「互換性」*に記載されている15種類の拡張子すべて、8つの言語すべてにわたる、読み取り可能なすべてのマークアップファイルタイプのハンドラーとして登録できます。登録されると、エクスプローラーでこれらのファイルをダブルクリックすると、直接Markzenで開かれ、複数のエディターがインストールされている場合でも、「プログラムから開く…」でMarkzenを選択できます。

キーボードショートカット

キー アクション
Ctrl+S 保存
Ctrl+Shift+S 名前を付けて保存
Ctrl+ + / Ctrl+ - テキストサイズの拡大/縮小

標準のエディターショートカット(検索、置換、コピー、貼り付け、元に戻す、やり直し)と書式設定ツールバーのショートカット(太字 Ctrl+B、斜体 Ctrl+I、見出し Ctrl+H、リンク Ctrl+K など)はエディターペインで機能します。書式設定ショートカットは、現在のマークアップにその構造がある場合にのみ存在します。Ctrl+D は、独自の取り消し線がないAsciiDocドキュメントでは何も行いません(「エディター」を参照)。

ヒント

  • **エディターを非表示にして読む。**プレビューを表示した単一ビューにすると、Markzenはクリーンなリーダーになり、5つのスタイルテンプレートで見た目を設定できます。
  • **1つのドキュメント、あらゆる種類のコンテンツ。**Mermaidフローチャート、KaTeX数式、楽譜が通常の散文の隣に配置でき、それらはすべて一緒にレンダリングされ、PDFおよびHTMLエクスポートでもすべて残ります。
  • **スタイルテンプレートはエクスポートの外観です。**選択したテンプレートは、PDFおよびHTML出力に組み込まれるスタイルなので、エクスポートする前に設定してください。
  • **好きなマークアップで書き、必要な形式で提供する。**Markdown(または8つのいずれか)で下書きし、Wordファイル、スライドデッキ、電子書籍、またはLaTeXソース用に「変換」を使用します。別のツールは必要ありません。
目次