Staccarta Preview

より読みやすいmdコードを書きましょう。

StaccartaはPDF、HTML、そしてソースコードさえも読みやすい、日本語文書向けの軽量マークアップ言語です。

この拡張機能は、Markdown（CommonMark系）およびStaccarta記法で書かれたmd原稿のプレビューとPDF・HTML出力を提供します。

現在はα版です。

原稿例

上位タイトル
文書タイトル
===

### 改行と空行
見出しの直後に空行なしで本文を入れられます。
空白2つやバックスラッシュなしで段落内改行ができます。

通常通り空行一つで段落を分けることができます。


さらには空行を二つ入れることでより大きなまとまりを表現できます。


### リスト
リストの直前に、空行なしで本文をいれられます。
- 一つ目の項目
- 二つ目の項目
リストの直後にも、空行なしで本文を続けられます。

出力例

詳しい書き方は、Staccarta記法ガイドを参照してください。

プレビュー

原稿を開き、エディター右上のStaccartaアイコンを押します。コマンドパレットの「Staccarta: PDFプレビューを開く」からも表示できます。

編集内容は保存前でも自動で反映されます。プレビュー右上のボタンでPDF表示とHTML表示を切り替えられます。

PDF・HTMLで保存する

原稿を右クリックし、「Staccarta: PDFで出力」または「Staccarta: HTMLで出力」を選び、保存先を指定します。プレビューを開く必要はありません。

PDF生成には、同梱のTypstを使用します。

Markdownとの関係

CommonMark系のMarkdown記法を基礎とし、.mdファイルを入力できます。Staccarta向けに書いた.mdも、既存のMarkdownエディターやCommonMark系のプレビューで利用できます。ただし、改行・余白や一部の文書構造の表示は異なります。

.mdでは既存のMarkdown編集支援を利用できます。専用拡張子の.stcaでは、Staccartaのリスト入力補助・アウトライン・構文チェックを利用できます。

markdownlintを使用する場合は、markdownlint設定ガイドに沿って、空行や見出しなどの検査ルールをStaccarta向けに調整してください。

対応環境と制限

Windows x64・macOS Intel・macOS Apple Silicon向けです。Apple Silicon版は実機未確認の試験対応です。

CommonMarkの全機能には対応しておらず、画像・引用などは未対応です。

今後の開発予定は、ロードマップを参照してください。

問題報告

不具合や要望は、asagi.dyce@gmail.comへお寄せください。不具合の場合は、OS・VS Code・Staccartaのバージョンと、問題が起きる原稿例を添えてください。原稿例には機密情報や個人情報を含めないでください。

ライセンス

作者：浅葱賽子（Asagi Dyce）。Staccartaの自作部分はMITライセンスです。同梱ソフトウェアのライセンスは、拡張機能フォルダーのLICENSE、THIRD-PARTY-NOTICES.txtとruntime内のライセンス通知に収録しています。