Markdown

Wiki ＞ Markdown

Markdownについて学びましょう！

#html{{

div class="panel panel-danger">

 <div class="panel-heading">キーワード</div>
 <div class="panel-body">

}}

• Markdown

#html{{

 </div>

/div>
}}

Markdownとは？†

Wikiなど文書作成で使われる計量なマークアップ言語。HTMLよりも簡単に書けるのが特徴。その代わり機能もショボイ？

• Markdown - Google 検索
  https://www.google.com/search?q=Markdown

• Markdown - Wikipedia
  https://ja.wikipedia.org/wiki/Markdown

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

公式サイト†

Markdownの本家

• Daring Fireball: Markdown
  https://daringfireball.net/projects/markdown/

リンク†

• GitBook
• AsciiDoc
• Wiki
• CMS

ライブラリー ／ フレームワーク†

PHPでMarkdownを扱うライブラリー

• PHP Markdown
  https://michelf.ca/projects/php-markdown/

Tips†

Markdownで書かれた本†

1. GitHubで本のソースコードの中身を見ると、「.md」ファイル（Markdown形式）がズラズラと並んでいる。
2. AsciiDocではなかった。
3. Markdown記法のファイルは、GitBookで本などの文書に変換できる。

• JavaScript Primer - 迷わないための入門書 #jsprimer
  https://jsprimer.net/

• 本のソースコード（GitHubで公開されている）
  • GitHub - asciidwango/js-primer: JavaScript Primer - 迷わないための入門書
    https://github.com/asciidwango/js-primer

• 本、Kindle

  #html{{

  table border="0" cellpadding="5"><tr><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4048930737/vertex9-22/" target="_blank"><img src="" border="0"></a></td><td>　</td><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4048930737/vertex9-22/" target="_blank">JavaScript Primer 迷わないための入門書</a><br>azu<br>KADOKAWA<br>2020-04-27<br>￥4180</td></tr></table>
  }}

AsciiDocとMarkdownの使い分け案†

確かに記法の表現力を見ると、AsciiDocの方がMarkdownよりも豊かで高機能だが、どちらもHTMLと併用することは可能だ。
表現力が貧弱なMarkdownを使いつつも、Markdownの表現力で不足する部分は、HTMLで書いても良い。（HTMLが分かる人にとっては大した手間でない？）
複雑な表組（テーブル）が若干弱いと思えるが、他は構わないだろうか。

覚えることが少ない分だけ、Markdownの方が使いやすいかもしれない。（えーっと、どう書くんだっけ？みたいな迷いが少ないかも）
本やPDFに変換する場合は、いったんDTPソフトに流し込んで、細かな編集作業を経ても良いだろう。
＝編集時間はかかるが、パワフルなDTPソフトを使えば、簡易ツールにはないデザイン性を付加できるはずだ。

大事なのは、コンテンツの中身であり、原稿の書式は2の次。
後からいくらでも変換することも可能なはずだ。

とりあえず軽量マークアップ言語は、Markdownから始めて、どうしても役不足だとか、不足をHTMLで補うのが手間となれば、その時点でAsciiDoc導入に移行しても良い。

1. スピード感を重視するなら、まずは簡単なMarkdownで書き出す。
2. Markdownに慣れたら、それが比較基準として使えるようになるはずなので、その時点で改めてAsciiDocとの比較検討を行う。
3. AsciiDocを導入するメリットがあると判断したら、学習コストを割いてもOK。
   1. 過去のMarkdown記法の原稿は、必要に応じてAsciiDoc等へ変換して、引き継げば問題ないはず。

判断の根拠†

最初から完璧を狙って、時間を停滞／浪費するよりも、不完全・未熟でもすぐに始めた方が良い。
コンテンツ作成という問題に関しては、人命に関わるような重大インシデントは発生しないので、多少のミスや不完全さがあっても問題にはならない。（校正でフォロー可能）

→最初の取組みは、DokuWiki ＋ Markdownのプラグインで始めても、大丈夫だろう。
ただ、それに安住せずに、同時にもっと良い仕組み作りには取り掛かるべきであろう。

#html{{

!--

hr>

• >
  }}

#html{{

center><a href="http://px.a8.net/svt/ejp?a8mat=1O73NW+3B2PRM+D8Y+BXB8X" target="_blank"><img border="0" width="468" height="60" alt="" src="http://www21.a8.net/svt/bgt?aid=101108300200&wid=001&eno=01&mid=s00000001717002003000&mc=1"></a><img border="0" width="1" height="1" src="http://www18.a8.net/0.gif?a8mat=1O73NW+3B2PRM+D8Y+BXB8X" alt=""></center>
}}

#html{{

h3 class="well">メニュー</h3>
}}

• 記事一覧
• 書籍紹介
• アイデア

• デザイン
• プログラミング
• ネットワーク・インフラ
• IoT (電子工作)
• ビジネス

#html{{

h3 class="well">まとめ</h3>
}}

• IT用語集
• ネットワーク用語
• ネットワーク講座
• ネットワークスペシャリスト

• DApps (Web 3.0)
• Haskell
• OCaml

• JavaScript
• Elm
• React
• PHP
• CodeIgniter
• WordPress

#html{{

!-- Google Ads -->

script type="text/javascript"><!--
google_ad_client = "ca-pub-1656096348298445";
/* sagasite.info_250x250_20110808 */
google_ad_slot = "6542397273";
google_ad_width = 250;
google_ad_height = 250;

/script>

script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">

/script>
}}

最新の10件

人気の10件

#html{{

p align="center">

a href="http://s09.flagcounter.com/more/lQC"><img src="http://s09.flagcounter.com/count/lQC/bg=FFFFFF/txt=000000/border=CCCCCC/columns=2/maxflags=20/viewers=0/labels=1/" alt="free counters" border="0"></a>

/p>
}}

#html{{

p align="center">

a href="http://px.a8.net/svt/ejp?a8mat=1O73NW+3B2PRM+D8Y+BXYE9" target="_blank">

img border="0" width="125" height="125" alt="" src="http://www28.a8.net/svt/bgt?aid=101108300200&wid=001&eno=01&mid=s00000001717002006000&mc=1"></a>

img border="0" width="1" height="1" src="http://www11.a8.net/0.gif?a8mat=1O73NW+3B2PRM+D8Y+BXYE9" alt="">

/p>
}}

#html{{

!-- X:S ZenBackWidget -->

!--

script type="text/javascript">document.write(unescape("%3Cscript")+" src='http://widget.zenback.jp/?base_uri=http%3A//program.sagasite.info/wiki/&nsid=94351984097772224%3A%3A95034570365255946&rand="+Math.ceil*1+"' type='text/javascript'"+unescape("%3E%3C/script%3E"));</script>

• >

  !-- X:E ZenBackWidget -->
  }}