我的日常使用之Markdown


我的日常使用之Markdown

Markdown 是一種輕量級的標記語言,由John Gruber和Aaron Swartz創建,最初是用來定義一種將文本轉換成html文件的工具markdown,項目主頁見:Markdown。它是開源項目,並以BSD-style許可證的許可方式以插件形式或內容管理系統形式發布。 本文就是用Markdown書寫的,可能在blog里面不是很好看。將其復制到我推薦的Markdown工具里面,就可以看到效果了。

其他關於Markdown的信息大家可以自己Google,我個人覺得Markdown對我最大的用處在於寫筆記和寫博客,其簡單的書寫形式可以讓我把注意力放在內容本身而不用去管眾多標簽問題(我以前是用xml格式寫筆記的,用docbook組織內容多餓文檔),目前也有很多Markdown+disqus維護博客的例子:

Julialang

Worldhello

注意:理解Markdown呈現穩定的機制一定不能死記硬背什么會有段落,什么會怎樣縮進。而應該將相應的效果對應到html的標簽上,想着html對相應的標簽會產生什么樣的效果。要知道Markdown本身就是為了將文檔轉換為html而生的。

工具篇:

下面推薦幾個編輯Markdown的工具

使用篇:

一、段落分配

#標題一
##標題二
###標題三
####標題四
#####標題五
######標題六

最大這能到標題六

這會產生代碼:

<h1>標題一</h1>
<h2>標題</h2>
<h3>標題一</h3>
<h4>標題一</h4>
<h5>標題一</h5>
<h6>標題一</h6>

兩個段落之間用一個空行間隔。這里和上面就是兩個段落,產生的html代碼中會用

標簽包裹每個兩個空行之間的內容。

二、列表和強調

在寫筆記和博客時免不了用到列表,Markdown提供了方便的列表表示方式。

  • 列表項,星號后面得有空格
  • 同星號一樣效果
  • 同上面一樣效果,這些是無序列表.
    1. 列表下面再緊跟着其他的列表將會被認為是列表的嵌套
    2. 有序列表

只有中間有段落隔開后才能開始新一層的列表

  1. 新的有序列表
  2. 有序列表可以用"1 2 3 "來排序,但其實無論寫什么數字,最終Markdown都會產生html代碼 以“ol”標簽包裹的列表項,而無序列表則是由“ul”標簽包裹的列表項

示例輸出html代碼

<ol> <!--同樣適用於ul標簽-->
    <li>……</li>
    ……
</ol>

如果想在文章中強調某個詞:

*強調*
**大強調**
***大大強調***

會在產生的html文件中生成如下代碼:

<em>強調</em> 
<strong> 大強調 </strong> 
<strong><em>大大強調</em></strong> 

三、引用和代碼

有個引用,默認自成一段無需段落留白 應用是以“>”開頭的后面加上空格或TAB,然后跟引用內容。會產生html代碼:

<blockquote> <p>有個引用</p></blockquote>

插入代碼
在書寫代碼時用個TAB鍵后跟代碼即可。這里我再重申一次:
不要用寫word的思維來看Markdown,想想在html里面寫內容時用了TAB鍵,結果會顯示么?

int main()
{
    int i;
    i = 0;
    return 0;
}
這里的代碼塊中間不能斷,即同一代碼塊里面的內容都放在同一縮進內

一對`(撇號,鍵盤上“1”左邊的按鍵)包裹的內容也可以表示代碼。結果會用

<p><code></code></p>

包裹。省去了用縮進。感覺不是很好用只是在表示html代碼時比較好用。而是用TAB縮進的內容會被

<pre><code></code></pre>

包裹。

四、鏈接和圖片

當需要在文中插入鏈接或圖片時,可以使用Markdown提供的鏈接操作:

  • []() 如:谷歌,三個內容分別是鏈接內容,目的地url,以及雙引號里面的title屬性
  • [][] 如:的鏈接方式,兩個內容依次是鏈接內容和鏈接id,鏈接id是像寫參考文獻一樣羅列在文檔某處的,我一般放在結尾,很有種寫論文的感覺,呵呵。。羅列示例

[0]: http://daringfireball.net/projects/markdown/ "MarkDown 主頁"

[1]: http://google.com "這樣以引用的方式統一組織鏈接信息"

用方括號擴住鏈接ID,然后是冒號,空格,目的url,空格,title屬性

插入圖片也有兩種方式:

可見圖片鏈接和普通的鏈接非常相似,只是開頭多了個驚嘆號,鏈接內容變成了alt屬性。

最后一個覺得有用的標簽

下面是分割線:


小結


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM