🦁

Markdown記法って何?

2024/05/06に公開

ZennやGithubでREADMEを書くにあたってどうやらMarkdown記法ってもので書けるらしいけど、
そもそもMarkdown記法ってなんなのかよくわからないため調べてみた。

Markdown記法ってどういう言語なの?

Markdown(マークダウン)は、文書を記述するための軽量マークアップ言語のひとつである。本来はプレーンテキスト形式で手軽に書いた文書からHTMLを生成するために開発されたものである。しかし、現在[いつ?]ではHTMLのほかPowerPoint形式やLATEX形式のファイルへ変換するソフトウェア(コンバータ)も開発されている。各コンバータの開発者によって多様な拡張が施されるため、各種の方言が存在する。 wikipeadie

ってことで簡単にHTMLとかを書きましょうよって言語らしい。MarkdownとMarkup言語が名前が似てるだけどころかめっちゃ関連しれるんだ。
次に書き方も調べていくと、どうやら方言があるらしい。
GithubもGitHub Flavored Markdownって独自の仕様を加えたMarkdown記法みたいで、そういうのを方言っていうってことか。

ひっかかったところ

検索すれば書き方はいくらでもでてくるが、自分が書き方を学ぶ上でつまずいたところをご紹介。

半角スペースを忘れないで

例えば見出しで#などを用いるときに#タイトルというふうに#とタイトルの間に半角スペースがないと見出しとして認識されない。これ以外でも半角スペースが前後に必要かどうかを注意していけば他はとくにひっかかることなくあとは書けそうな気がする。
https://zenn.dev/zenn/articles/markdown-guide#fn-a52b-1

Discussion