Lantana Lantana

  • Welcome to Lantana!
  • クレジット
  • Lantana(キャラクター)のプロフィール
  • チートシート
    • 設定ファイル
    • マークダウン記法
    • メタタグ
  • チュートリアル
    • 作業開始
      • インストール
      • サイトを作成する
      • 記事を執筆する
  • 共同作成者ガイド
  • WSOFT
目次
  • 普通のテキスト
  • エスケープ
  • 明示的な空行
  • コメント
  • 見出し
  • テキストの装飾
  • コードブロック
  • 数式
  • 順序なしリスト
  • 番号付きリスト
  • タスクリスト
  • 水平線
  • URL
  • リンク
  • タイトル付きリンク
  • リンクの使いまわし
  • 画像
  • 表
  • 引用
  • 図形
  • アラート
  • 記事一覧
  • スニペットの埋め込み
  • HTMLの埋め込み
  • 属性の追加

マークダウン記法

  1. Lantana
  2. チートシート
  3. マークダウン記法

この記事では、Lantanaで使用できるマークダウン記法の一覧を示します


たい | 2022-10-22

普通のテキスト

そのまま記述可能です。

例
Lantanaは、シンプルで軽量なMKDocsのテーマです。
HTMLの知識がなくても簡単にサイトを作成できます。

改行するには、一行空行を挟みます。
結果

Lantanaは、シンプルで軽量なMKDocsのテーマです。 HTMLの知識がなくても簡単にサイトを作成できます。

改行するには、一行空行を挟みます。

エスケープ

マークダウンで意味のある文字(たとえば、*や#など)をテキストとして表示するには、エスケープが必要です。

例
\*\#\!\`\\

結果

*#!`\

明示的な空行

二行以上にわたって改行したい場合など、一部の場合ではHTMLの<br/>タグを使用します。

例
<br/>

コメント

記事にコメントを記述する方法はHTMLと同じです。ビルド時に削除されます。

例
<!-- this is a comment. -->

見出し

Hタグを生成します。記事にタイトルが指定されていない場合、自動的に記事の一番最初の見出しがタイトルになります。

また、見出しは目次にも表示されます。

例
# これはH1タグになります
## これはH2タグになります
###### これはH6タグになります
結果

これはH1タグになります

これはH2タグになります

これはH6タグになります


テキストの装飾

文章を様々に装飾する方法をまとめて紹介します。

例
_ か * で囲むとHTMLのemタグになり、 *このように* 表示されます。

__ か ** で囲むとHTMLのstrongタグになり、**このように** 表示されます。

それらを組み合わせることもできます。*** で囲むと、***このように*** 表示されます。

~~ で囲むと打消し線になり、 ~~このように~~ 表示されます。

^^ で囲むと下線がつき、^^このように^^ 表示されます。

== で囲むとハイライトがつき、==このように== 表示されます。

~ で囲むと下付き文字になり、使用すると~このように~表示されます。

^ で囲むと上付き文字になり、使用すると^このように^表示されます。

++ で囲むと++ctrl+alt+del++のようにキーボードのキーを表現できます。

また、`print("Hello,World!");`と記述することでコードをインライン表示できます。
_ か * で囲むとHTMLのemタグになり、 このように 表示されます。

__ か ** で囲むとHTMLのstrongタグになり、このように 表示されます。

それらを組み合わせることもできます。*** で囲むと、このように 表示されます。

~~ で囲むと打消し線になり、 このように 表示されます。

^^ で囲むと下線がつき、このように 表示されます。

== で囲むとハイライトがつき、このように 表示されます。

~ で囲むと下付き文字になり、使用するとこのように表示されます。

^ で囲むと上付き文字になり、使用するとこのように表示されます。

++ で囲むとCtrl+Alt+Delのようにキーボードのキーを表現できます。

また、print("Hello,World!");と記述することでコードをインライン表示できます。

コードブロック

``` で囲むことでコードとして認識され、初めを```言語名 とすることでシンタックスハイライトがつきます。title="タイトル"とすることでファイル名なども表現できます。

例
``` csharp title="Program.cs"
using System;

public class Program
 {
    public static void Main()
     {
            Console.WriteLine("Hello World!");
     }
 }
 ```

結果

Program.cs
using System;

public class Program
 {
    public static void Main()
     {
            Console.WriteLine("Hello World!");
     }
 }

注意

テーブルのデザインや一貫性の問題から、linenums=1属性はLantana2.0から非推奨になりました。

数式

\$\$で囲むことでTeX記法を用いて数式を記述できます。

例
$$
\operatorname{ker} f=\{g\in G:f(g)=e_{H}\}{\mbox{.}}
$$
結果

\[ \operatorname{ker} f=\{g\in G:f(g)=e_{H}\}{\mbox{.}} \]

$または\(...\)で囲むことで、数式を文中に埋め込むこともできます。

例
ディッフィー・ヘルマン鍵共有プロトコルでは、まず大きな素数 ${\displaystyle p}p$ と、
${\displaystyle p-1}p-1$ を割り切る大きな素数 ${\displaystyle q}q$ を用意します。
また、 ${\displaystyle g}g$ を
${\displaystyle ({\mathbb {Z} }/p{\mathbb {Z} })^{\ast }}{\displaystyle ({\mathbb {Z} }/p{\mathbb {Z} })^{\ast }}$ の元で、
位数が ${\displaystyle q}q$ である値とします。
この ${\displaystyle p,q,g}{\displaystyle p,q,g}$ の値は公開されているものとします。
結果

ディッフィー・ヘルマン鍵共有プロトコルでは、まず大きな素数 \({\displaystyle p}p\) と、 \({\displaystyle p-1}p-1\) を割り切る大きな素数 \({\displaystyle q}q\) を用意します。また、 \({\displaystyle g}g\) を \({\displaystyle ({\mathbb {Z} }/p{\mathbb {Z} })^{\ast }}{\displaystyle ({\mathbb {Z} }/p{\mathbb {Z} })^{\ast }}\) の元であり、位数が \({\displaystyle q}q\) である値とします。この \({\displaystyle p,q,g}{\displaystyle p,q,g}\) の値は公開されているものとします。

順序なしリスト

リストの上には空行が必要です。

例
* 文頭に"*"、"+"、"-"のいずれかを入れると順序なしリストになります
+ 記号のあとには**スペースが必要**です
- 同じリストでは同じ記号を使うことを推奨します。
結果

  • 文頭に"*"、"+"、"-"のいずれかを入れると順序なしリストになります
  • 記号のあとにはスペースが必要です
  • 同じリストでは同じ記号を使うことを推奨します。

番号付きリスト

リストの上には空行が必要です。

例
1. 文頭に"数字."を入れると番号付きリストになります。
1. "数字."のあとには**スペースが必要**です
1. すべての数字を1にすると、自動的に番号が付きます。
結果

  1. 文頭に"数字."を入れると番号付きリストになります。
  2. "数字."のあとにはスペースが必要です
  3. すべての数字を1にすると、自動的に番号が付きます。

タスクリスト

順序なしリストの記述の後ろに[ ]を入れるとチェックボックスが生成されます。 また、チェックが入った状態のボックスを生成する場合は[x]を入力します。

例
- [ ] タスク1
- [x] タスク2
結果

  • タスク1
  • タスク2

水平線

例
---
結果


URL

Urlやメールアドレスを書くだけで、自動的にリンクになります。

例
https://lantana.wsoft.ws

[email protected]
結果

https://lantana.wsoft.ws

[email protected]

リンク

このサイト外へのリンクは新規タブで開かれます。

例
[リンク](about:blank)

[WSOFT](https://wsoft.ws/)
結果

リンク

WSOFT

タイトル付きリンク

タイトルはリンクをホバーした時に表示されます。

例
[リンク](about:blank "タイトル")
結果

リンク

リンクの使いまわし

例
[link]: about:blank
[ここ][link]と[ここ][link]は同じになります。
結果

こことここは同じになります。

また、linkという書き方もできます。

画像

例
![代替テキスト](https://wsoft.ws/products/Alice.jpg)

結果

代替テキスト

表

Bootstrapの制約により、ヘッダーでは左右中央揃えが適用されません

例
| Left align | Right align | Center align |
|:-----------|------------:|:------------:|
| This       | This        | This         |
| column     | column      | column       |
| will       | will        | will         |
| be         | be          | be           |
| left       | right       | center       |
| aligned    | aligned     | aligned      |

結果

Left align Right align Center align
This This This
column column column
will will will
be be be
left right center
aligned aligned aligned

引用

例
> 文頭に>を置くことで引用になります。
> 複数行にまたがる場合、改行のたびにこの記号を置く必要があります。
> 
> 引用の中に別のMarkdownを使用することも可能です。
> 
> > これはネストされた引用です。
結果

文頭に>を置くことで引用になります。 複数行にまたがる場合、改行のたびにこの記号を置く必要があります。

引用の中に別のMarkdownを使用することも可能です。

これはネストされた引用です。

図形

Lantanaは規定でmermaid.jsをサポートします。mermaid.jsを使うと、複雑な図形を簡単に挿入できます。

例
```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
結果
graph TD; A-->B; A-->C; B-->D; C-->D;

アラート

目を引く形で説明したい場合、!!! 種類 "タイトル"で囲みます。

例
!!! note "メモ"
    `note`で使用できる装飾です。[リンク](#)は自動的に適切な色になります。
結果

メモ

noteで使用できる装飾です。リンクは自動的に適切な色になります。

Abstract

abstractで使用できる装飾です。リンクは自動的に適切な色になります。

Info

infoで使用できる装飾です。リンクは自動的に適切な色になります。

Tip

tipで使用できる装飾です。リンクは自動的に適切な色になります。

Success

successで使用できる装飾です。リンクは自動的に適切な色になります。

Question

questionで使用できる装飾です。リンクは自動的に適切な色になります。

Warning

warningで使用できる装飾です。リンクは自動的に適切な色になります。

Failure

failureで使用できる装飾です。リンクは自動的に適切な色になります。

Danger

dangerで使用できる装飾です。リンクは自動的に適切な色になります。

Bug

bugで使用できる装飾です。リンクは自動的に適切な色になります。

Example

exampleで使用できる装飾です。リンクは自動的に適切な色になります。

Quote

quoteで使用できる装飾です。リンクは自動的に適切な色になります。

記事一覧

= "" =で囲い、その中にディレクトリを指定すると、そのディレクトリの記事一覧を出力します。

例
= "cheatsheet" =\

スニペットの埋め込み

--8<--で囲い、その中にファイル名を書き込むと、そのファイルを埋め込みます。

例
--8<--
snippet.md
--8<--

HTMLの埋め込み

HTMLコードは、そのまま記述することで埋め込むことができます。

例
<h4>これはHTMLのH4タグです</h4>
結果

これはHTMLのH4タグです

属性の追加

{: 属性名}とするとマークダウンで生成される要素に特定の属性を追加することができます。

例
### この要素にはqueryというIdがつきます {: #query }
結果

以下のようなHTMLが生成されます

<h3 id="query">この要素にはqueryというIdがつきます</h3>

Copyright © 2022 WSOFT All rights reserved.

検索
No results found