Markdown記法関連で調べたこと
概要
Zennで使用できるMarkdown記法を深掘りし調べたことのメモ
▼Mermaid(フローチャート)
- Zenn Mermaid Cheat Sheet
https://jojozhuang.github.io/tutorial/mermaid-cheat-sheet/
▼テーブル内で改行する場合
▼Markdown早見表
Zennで使用できるか未検証
▼Markdownでコメントアウトする方法
(Markdown早見表にも記載があった。)
▼数式の書式(KaTex)について
▼コードブロック内でバッククォートを表示したい場合
▼Excelの表をMarkdown形式に置き換える便利なExcelのアドオン「RelaxTools」
▼Zenn.devでテキストリンクを同じタブで開く方法
-
markdown記法を使ってZenn.devで同じタブを開く方法
<!-- 通常のテキストリンク → 別タブで開く(target="_blank") --> [別タブで開く(target="_blank")](https://zenn.dev/haretokidoki/scraps/9319e748e3120e) <!-- 相対パスでリンクを指定 → 同じタブで開く(target="_self") --> [同じタブで開く(target="_self")](./9319e748e3120e)
下記が実際にmarkdown記法で書いたテキストリンク。
ただし、リンクカード形式で掲載する
@[card](対象のURL)
の場合は、相対パスで記載しても「不正なURLです。」と表示され、正しく表示されない仕様みたい。
下記が絶対パス「@[card](https://zenn.dev/haretokidoki/scraps/9319e748e3120e)
」でリンクカード形式のリンクを記載。下記は相対パス「
URLが不正です@[card](./9319e748e3120e)
」でリンクカード形式のリンクを記載。なお、こちらの記事によると他のプラットフォームでは、
[表示する文字](対象のURL){:target="_blank"}
のような方法でリンクの動作を指定できるプラットフォームもあるみたい。 -
<a>タグを使ってZenn.devで同じタブを開く方法
2024年2月現在、Zenn.devで<a>タグを使ったテキストリンクはできなかった。<a href="https://zenn.dev/haretokidoki" target="_self" rel="noopener noreferrer">このリンクは同じタブで開く</a>
下記が実際に<a>タグを使ったテキストリンク。
<a href="https://zenn.dev/haretokidoki" target="_self" rel="noopener noreferrer">このリンクは同じタブで開く</a>上記のとおり、うまく解釈されていない。
そもそも、ココの箇所はmarkdownの箇条書き内で記載してる為、おそらくどのプラットフォームでも<a>タグとして解釈されないと思われる。
ただ、他のプラットフォームでは、markdown記法をしていない行に記載すると<a>タグとして解釈されるものもあるらしい。<a>タグに関する簡単な説明
<a>タグで
target=_self
と指定する事により同じタブで開く動作に。
また、rel="noopener noreferrer
に関しては、こちらの記事にある通り、セキュリティの観点から付与した方がよいとのこと。
参考情報:<a>: アンカー要素 - HTML: ハイパーテキストマークアップ言語 | MDN
下記は、箇条書き外の<a>タグ。
<a href="https://zenn.dev/haretokidoki" target="_self" rel="noopener noreferrer">このリンクは同じタブで開く</a>
2024年2月現在、やはりZenn.devでは<a>タグは使用できない。