日韩性视频-久久久蜜桃-www中文字幕-在线中文字幕av-亚洲欧美一区二区三区四区-撸久久-香蕉视频一区-久久无码精品丰满人妻-国产高潮av-激情福利社-日韩av网址大全-国产精品久久999-日本五十路在线-性欧美在线-久久99精品波多结衣一区-男女午夜免费视频-黑人极品ⅴideos精品欧美棵-人人妻人人澡人人爽精品欧美一区-日韩一区在线看-欧美a级在线免费观看

歡迎訪問 生活随笔!

生活随笔

當(dāng)前位置: 首頁 > 编程资源 > 编程问答 >内容正文

编程问答

【转】我们为什么要使用 Markdown

發(fā)布時間:2023/12/14 编程问答 36 豆豆
生活随笔 收集整理的這篇文章主要介紹了 【转】我们为什么要使用 Markdown 小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.

【轉(zhuǎn)】我們?yōu)槭裁匆褂?Markdown

目錄

  • 從前碼字時我們面臨著什么困境
  • 標(biāo)記語言顯神威
  • 到底什么是 Markdown
  • 所以為什么我們要使用 Markdown
  • Markdown 簡明語法
    • 段落和換行
    • 標(biāo)題
    • 區(qū)塊引用
    • 列表
    • 強(qiáng)調(diào)
    • 代碼標(biāo)識和代碼區(qū)塊
    • 分割線
    • 鏈接
    • 圖片
    • 自動鏈接
    • 反斜杠
  • Markdown 進(jìn)階語法
    • 錨點(diǎn)鏈接
    • LaTeX 公式
    • 表格
    • 刪除線
    • 注腳
    • 流程圖
    • 內(nèi)容目錄
  • Markdown 編輯器推薦
    • 馬克飛象
    • 作業(yè)部落 - CMD Markdown
    • 簡書
    • 終端軟件
  • 結(jié)語
  • 參考

本文轉(zhuǎn)自:https://kchen.cc/2015/10/05/Markdown-Manual/

Markdown 是一種正在流行起來的「標(biāo)記語言」,通常為程序員群體所用。但現(xiàn)在,不光是程序員,對于普通的文字編輯者而言,Markdown 的優(yōu)勢也越來越明顯了。

從前碼字時我們面臨著什么困境

以前,大部分的人使用 Word 或 Pages 碼字、寫作、寫論文,過去的文檔也大都以.doc, .docx格式或是.pages格式儲存。還有人為了編輯簡潔、保證文稿發(fā)給誰都能正常打開,會用.txt 格式。

.doc或.pages格式有如下問題:

  • 文件格式難兼容:不一定誰都能打開。用 Windows 的人打不開.pages文件,用舊版 Word 的人不一定能打開你用新版 Word 寫的稿子,而且在其他操作系統(tǒng)下(雖然這是少數(shù))打開.doc的體驗(yàn)一向很糟糕。
  • 顯示效果不統(tǒng)一:對方看到的稿子的樣子和你自己看到的可能差別很大,可能是因?yàn)椴煌能浖婺?#xff0c;可能是不同的系統(tǒng)平臺。
  • 功能繁復(fù)分人心:寫 Word 文檔的時候,我們經(jīng)常浪費(fèi)大量時間在 Word 本身上,特別是那80%我們用不到的功能,而且 Word 越來越臃腫的身軀,讓每一次打開文件都是一種痛苦。
  • 排版耗時又耗力:使用 Word 時,我們會花費(fèi)大量力氣去排版,試圖讓文檔變得漂亮一些。是粗體還是斜體,是宋體還是黑體,對創(chuàng)作來說,有那么重要嗎?而且有相當(dāng)一部分人為了簡便,甚至不能正確的設(shè)置標(biāo)題級別,僅僅是使用變大字號和加粗來表明「我是一個標(biāo)題」。
  • 版本管理真著急:每一位自殺的寫作者的電腦文檔里面,都必然有一個 Word 文檔,從V1.0到V20.0的無數(shù)版本……這樣的版本管理方式是落后且低效的。
  • 協(xié)同工作在哪里:想想你讓一位合作的編輯幫你改書有多么痛苦,一個Word文檔來,一個Word去,使用那極其難用的修訂與審閱功能,你就理解了。
  • 盜版卄年不心虛:Office 已經(jīng)是你電腦上用得最久的盜版軟件,導(dǎo)致心情不佳。

標(biāo)記語言顯神威

既然使用 Word 來碼字這么鬧心,我干脆寫個純文檔算了,或者直接打開記事本,寫個.txt多簡單!可是.txt格式的問題在于沒有樣式:收到文檔的人甚至不知道哪里是標(biāo)題,哪里需要加粗,哪里是引用,更別說在文檔里插個圖片了。

有人肯定靈機(jī)一動,我在旁邊標(biāo)注一下不就行了么:

在山的那邊海的那邊有一群藍(lán)精靈(這是一個標(biāo)題)

作者實(shí)在太機(jī)智,是的,看到稿子的正常人應(yīng)該都會把(這是一個標(biāo)題)當(dāng)做備注處理,剔除于正文之外。其實(shí),這就是「標(biāo)記語言」的原型了,不過試想一下,如果一篇文章充滿了

在山的那邊海的那邊有一群藍(lán)精靈(這是一個標(biāo)題)

他們(強(qiáng)調(diào))活潑(強(qiáng)調(diào)結(jié)束)又聰明(這是一個子標(biāo)題)

他們調(diào)皮(注:藍(lán)精靈們喜歡惡作劇)又靈敏(這也是一個子標(biāo)題)

的確挺讓人抓狂的,所以為了約定俗成,天才的 John Gruber 和 Aaron Swartz1 共同發(fā)明了 Markdown 這門輕量級的標(biāo)記語言,它使用像#、*、-這樣的符號來標(biāo)記標(biāo)題、強(qiáng)調(diào)甚至列表。

到底什么是 Markdown

在詳細(xì)介紹 Markdown 之前,我不得不提一提 Markdown 的精神理念。

Markdown 的目標(biāo)是「易讀易寫」。

為實(shí)現(xiàn)這一目標(biāo),Markdown 的語法幾乎全部由標(biāo)點(diǎn)符號構(gòu)成,這些標(biāo)點(diǎn)符號都是精心挑選而來,是與寫作的習(xí)慣一脈相承的,每一個符號都盡量做到能望文生義。如:星號 * 括著一個單詞(Markdown 中表示強(qiáng)調(diào))看上去就像強(qiáng)調(diào);Markdown的列表看上去就像列表;Markdown 的引文就像引文,和你使用 e-mail 時的感覺一樣。

它實(shí)際上是個非常簡單、非常容易學(xué)習(xí)的語法。這個語法簡單到每個人都可以在5分鐘以內(nèi)學(xué)會,這樣低廉的學(xué)習(xí)成本可以讓你毫無負(fù)擔(dān)地投入它的懷抱。

有了 Markdown 之后,我們編輯文字時就可以專注于文字的內(nèi)容本身,而不用分心去關(guān)注文字的排版,甚至于可以說在它簡單到不能再簡單的語法下,你根本就沒有思考排版的空間,也沒必要思考。也正因?yàn)?Markdown 的語法格式足夠簡單,所以開發(fā)者非常容易生成漂亮的版式,一切既有的CSS都可以簡單修改之后套用,比如這樣:

再比如這樣

所以為什么我們要使用 Markdown

用 Markdown 有如下好處:

  • 兼顧了 .txt 文件什么系統(tǒng)環(huán)境都能打開和 .doc、.pages 文件系統(tǒng)的排版效果。因?yàn)橐环矫?Markdown 本身就是純文本,他可以保存為自己專有的 .md 格式,也可以保存為 .txt 等任何的純文本文件格式,所以什么系統(tǒng)都能打開。而它簡單的語法讓你可以用它來標(biāo)記文本豐富的樣式。
  • 由于是純文本,Markdown 文稿也不會因?yàn)槲磥碥浖壎a(chǎn)生不同版本之間的兼容問題,不會出現(xiàn)「此文件是由較高版本的 Microsoft Word 創(chuàng)建的。是否要下載兼容包以便使用此文件?」的惱人問題,也不會出現(xiàn)好不容易下載兼容包了之后發(fā)現(xiàn)打開文件全變了樣的尷尬。
    想要獲得豐富的表現(xiàn)樣式,你只需要使用不同的CSS來表現(xiàn)這些標(biāo)記元素即可,對于普通用戶而言,就是用不同的「工具」或者「瀏覽器」來打開 Markdown 文檔以獲得不同的表現(xiàn)樣式。
  • Markdown 轉(zhuǎn)換為其他格式非常的方便。HTML 是整個萬維網(wǎng)(web)的標(biāo)記語言,但更重要的是,它也是目前主流電子書格式所用的標(biāo)記語言。無論是 .EPUB 、.mobi,還是 Kindle 用的專有格式 .azw,都只是把一堆 HTML 文件打包而已。另外,后面的介紹的許多工具都能輕松地把 Markdown 文檔轉(zhuǎn)換成精美的 PDF 文檔存儲,便于出版和交流傳播。

  • Markdown 簡明語法

    前文我介紹了使用 Markdown 進(jìn)行文字編輯的優(yōu)勢,下面我希望用簡潔明了的方式為大家介紹一下 Markdown 的基本語法,進(jìn)一步向大家揭示 Markdown 的強(qiáng)大之處。

    段落和換行

    Markdown 以一段完整的空行作為段落間隔,「完整」的意思是允許你包含 ? space 空格符和 ? tab 制表符。單獨(dú)的一個 ? enter 回車符換行并不被認(rèn)為另起了一個段落,哪怕你像中文寫作一樣換行以后用 ? tab 制表符縮進(jìn)。

    我建議大家養(yǎng)成用一個完整的空行分割段落的習(xí)慣,這樣對于別人閱讀你的文章是很友好的,密密麻麻「摩肩接踵」的文字會讓人感到頭昏腦脹。

    標(biāo)題

    Markdown 支持兩種標(biāo)題的語法,類 Setext 和類 atx 形式。

    類 Setext 形式的標(biāo)題在標(biāo)題下一行使用連續(xù)兩個及以上=符號表示一級標(biāo)題,使用連續(xù)兩個及以上-符號表示二級標(biāo)題,例如:

    這是一級標(biāo)題 == 這是二級標(biāo)題 ---

    這是一級標(biāo)題

    這是二級標(biāo)題

    類 Atx 形式則是在行首插入1到6個 # 符號,對應(yīng)到標(biāo)題1到6階, # 符號和標(biāo)題之間需要一個空格,例如:

    # 這是一級標(biāo)題 ## 這是二級標(biāo)題 ### 這是三級標(biāo)題 #### 這是四級標(biāo)題 ##### 這是五級標(biāo)題 ###### 這是六級標(biāo)題

    這是一級標(biāo)題

    這是二級標(biāo)題

    這是三級標(biāo)題

    這是四級標(biāo)題

    這是五級標(biāo)題
    這是六級標(biāo)題

    區(qū)塊引用

    Markdown 標(biāo)記區(qū)塊引用是使用類似 e-mail 中用 > 的引用方式,在需要引用的文字之前使用 > 符號即可,注意在 > 符號與引文之間需要一個空格。

    當(dāng)你需要進(jìn)行區(qū)塊引用,也就是多段引用時,只需在每段之前都加上 > 符號,包括空行。

    引用允許嵌套使用,引文內(nèi)的引文只需要連續(xù)使用 > 符號即可。

    引文內(nèi)任何 Markdown 語法依舊生效,比如列表、標(biāo)題等。例如

    > 這是引文的第一段 > 這是引文的第二段 >> 這是內(nèi)嵌的二級引文 > ### 引文內(nèi)還可以使用標(biāo)題等其他語法標(biāo)記

    這是引文的第一段
    這是引文的第二段

    這是內(nèi)嵌的二級引文

    引文內(nèi)還可以使用標(biāo)題等其他語法標(biāo)記

    列表

    Markdown 支持非常直觀的無序列表和有序列表。

    無序列表使用 + 加號、- 減號和 * 星號加空格來標(biāo)識,列表的嵌套使用 ? space 空格符(建議使用4個)或 ? tab 制表符縮進(jìn),例如:

    這是一個無序列表 + 項(xiàng)目1 + 項(xiàng)目2 + 項(xiàng)目3這是一個無序列表 - 項(xiàng)目1 - 項(xiàng)目2- 項(xiàng)目2.1- 項(xiàng)目2.2 - 項(xiàng)目3這是一個無序列表 * 項(xiàng)目1 * 項(xiàng)目2 * 項(xiàng)目3* 項(xiàng)目3.1* 項(xiàng)目3.1.1

    這是一個無序列表

    • 項(xiàng)目1
    • 項(xiàng)目2
    • 項(xiàng)目3

    這是一個無序列表

    • 項(xiàng)目1
    • 項(xiàng)目2
      • 項(xiàng)目2.1
      • 項(xiàng)目2.2
    • 項(xiàng)目3

    這是一個無序列表

    • 項(xiàng)目1
    • 項(xiàng)目2
    • 項(xiàng)目3
      • 項(xiàng)目3.1
        • 項(xiàng)目3.1.1

    有序列表也非常的直觀,只需要使用數(shù)字接著一個 . 英文句點(diǎn)然后空格,就可以標(biāo)識一個有序列表了。值得一提的是任何一個數(shù)字都可以觸發(fā)有序列表,并按正確的數(shù)序予以顯示。例如:

    這是一個有序列表 1. 項(xiàng)目一 2. 項(xiàng)目二 3. 項(xiàng)目三這也是一個有序列表 8. 項(xiàng)目一 1. 項(xiàng)目二 3. 項(xiàng)目三

    這是一個有序列表

  • 項(xiàng)目一
  • 項(xiàng)目二
  • 項(xiàng)目三
  • 這也是一個有序列表

  • 項(xiàng)目一
  • 項(xiàng)目二
  • 項(xiàng)目三
  • 強(qiáng)調(diào)

    Markdown 使用 * 星號和 _ 下劃線作為標(biāo)記強(qiáng)調(diào)字詞的符號,被 * 或 _ 包圍的字詞會被顯示為斜體,用兩個 * 或 _ 包起來的話,則會被顯示為粗體,用兩個 * 或 _ 包起來的話,則會被顯示為粗斜體,例如:

    _我是一行斜體字_ **我是一行粗體字** ***我是一行粗斜體***

    我是一行斜體字
    我是一行粗體字
    我是一行粗斜體

    在這里說一句,因?yàn)橹形淖煮w鮮有斜體設(shè)計(jì),大部分字體顯示效果都不盡人意,所以不建議大家使用斜體強(qiáng)調(diào)中文。

    代碼標(biāo)識和代碼區(qū)塊

    作為一名碼農(nóng)常常需要往自己的文稿中寫入大量的代碼,而代碼的排版和顯示甚至于使用的字體與普通文字都是很不一樣的,Markdown 對于代碼區(qū)塊有很好的支持。值得一提的是,代碼區(qū)塊中的所有輸入都會按照原樣輸出,包括連續(xù)的空格。

    Markdown 中的代碼標(biāo)識主要有行內(nèi)代碼和代碼區(qū)塊兩種。行內(nèi)代碼用一對 反引號(位于鍵盤 ? esc 鍵下方)標(biāo)識。例如:

    我是可愛的 \`? command\` 鍵,當(dāng)我設(shè)置變量 \`int a = 20;\` 時,就可以內(nèi)嵌行內(nèi)代碼了。

    我是可愛的 ? command 鍵,當(dāng)我設(shè)置變量 int a = 20; 時,就可以內(nèi)嵌行內(nèi)代碼了。

    當(dāng)需要輸入大段的代碼時,只需要用一對連續(xù)3個 ` ` 反引號 ` ` 將代碼區(qū)塊包圍(enclose)起來就可以了,第一組反引號后可以標(biāo)注代碼塊的語言以幫助編輯器識別,例如:

    #include <stdio.h>#include <iostream>int main(){ printf("Hello world!"); // 教科書的寫法 puts("Hello world!"); // 我最喜歡的 puts("Hello" " " "world!"); // 拼接字符串 std::cout << "Hello world!" << std::endl; // C++風(fēng)格的教科書寫法 return 0;}

    還有一種產(chǎn)生區(qū)塊代碼的方式,是在每段的段首使用多于1個 ? tab 制表符或者4個 ? space 空格符進(jìn)行整體縮進(jìn)。由于這種方法不方便使用而且極易混淆視聽,所以我不推薦大家使用,也不多做介紹了,大家知道即可。

    hilight.js 支持的語法有:

    • 1C
    • ActionScript
    • Apache
    • AppleScript
    • AsciiDoc
    • AspectJ
    • AutoHotkey
    • AVR Assembler
    • Axapta
    • Bash
    • Brainfuck
    • Cap’n Proto
    • Clojure REPL
    • Clojure
    • CMake
    • CoffeeScript
    • C++/cpp
    • C#
    • CSS
    • D
    • Dart
    • Delphi
    • Diff
    • Django
    • Dockerfile
    • DOS .bat
    • Dust
    • Elixir
    • ERB (Embedded Ruby)
    • Erlang REPL
    • Erlang
    • FIX
    • Fortran
    • F#
    • G-code (ISO 6983)
    • Gherkin
    • GLSL
    • Go
    • Gradle
    • Groovy
    • Haml
    • Handlebars
    • Haskell
    • Haxe
    • HTTP
    • Ini
    • Java
    • JavaScript
    • JSON
    • Julia
    • Kotlin
    • Lasso
    • Less
    • Lisp
    • LiveCode
    • LiveScript
    • Lua
    • Makefile
    • Markdown
    • Mathematica
    • Matlab
    • MEL
    • Mercury
    • Mizar
    • Monkey
    • Nginx
    • Nimrod
    • Nix
    • NSIS
    • Objective C
    • OCaml
    • Oxygene
    • Parser3
    • Perl
    • pf
    • PHP
    • PowerShell
    • Processing
    • Python profile
    • Prolog
    • Protocol Buffers
    • Puppet
    • Python
    • Q
    • R
    • RenderMan RIB
    • Roboconf
    • RenderMan RSL
    • Ruby
    • Oracle Rules Language
    • Rust
    • Scala
    • Scheme
    • Scilab
    • SCSS
    • Smali
    • Smalltalk
    • SML
    • SQL
    • Stata
    • STEP Part 21 (ISO 10303-21)
    • Stylus
    • Swift
    • Tcl
    • TeX
    • Thrift
    • Twig
    • TypeScript
    • Vala
    • VB.NET
    • VBScript in HTML
    • VBScript
    • Verilog
    • VHDL
    • Vim Script
    • Intel x86 Assembly
    • XL
    • HTML, XML- >

    分割線

    你可以在一行中用三個以上的 * 星號、 - 減號、_ 下劃線來建立一個分隔線,行內(nèi)不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:(希望大家多使用分割線來分割自己文章的區(qū)塊,提高可讀性)

    --- ___ - - - - - __ _ ___

    鏈接

    Markdown 中對鏈接和圖片采取很舒服的表達(dá)方式,我們先來看看鏈接。

    Markdown 支持兩種形式的鏈接語法:行內(nèi)式和參考式兩種形式。

    行內(nèi)式的語法如下:

    [鏈接文字](鏈接地址) [鏈接文字](鏈接地址 "title屬性")

    其中(鏈接地址)如果是絕對地址請不要忘記加上http://,"title"屬性是指鼠標(biāo)移到鏈接上顯示的文字,這個屬性還可以應(yīng)用在空鏈接上實(shí)現(xiàn)特殊的效果,例如:

    歡迎關(guān)注我的微博[@悅?cè)A](http://www.weibo.com/quentinchen/) 歡迎蒞臨我的[簡書](http://www.jianshu.com/users/6e06e4695b9a/ "這是悅?cè)A的簡書") 這是[百度](http://www.baidu.com/) [請把鼠標(biāo)懸停在這里](#no-link "你會看到一條注釋"),不要點(diǎn)擊

    歡迎關(guān)注我的微博@悅?cè)A
    歡迎蒞臨我的簡書
    這是百度
    請把鼠標(biāo)懸停在這里,不要點(diǎn)擊

    參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標(biāo)記,接著,在文件的任意處,你可以把這個標(biāo)記的鏈接內(nèi)容定義出來:

    歡迎關(guān)注我的微博[@悅?cè)A][weibo] 歡迎蒞臨我的[簡書][jianshu] 這是[百度][1] [請把鼠標(biāo)懸停在這里][2],不要點(diǎn)擊其間可以有 任意多的文本[weibo]:http://www.weibo.com/quentinchen/ [jianshu]:http://www.jianshu.com/users/6e06e4695b9a/ "這是悅?cè)A的簡書" [1]:http://www.baidu.com/ [2]:#no-link "你會看到一條注釋"

    歡迎關(guān)注我的微博@悅?cè)A
    歡迎蒞臨我的簡書
    這是百度
    請把鼠標(biāo)懸停在這里,不要點(diǎn)擊

    其間可以有
    任意多的文本

    圖片

    很明顯地,要在純文字應(yīng)用中設(shè)計(jì)一個「自然」的語法來插入圖片是有一定難度的。

    Markdown 使用一種和鏈接很相似的語法來標(biāo)記圖片,只需要在鏈接的語法前面加一個 ! 感嘆號就可以了,同樣也允許兩種樣式: 行內(nèi)式和參考式。

    行內(nèi)式的語法如下:

    ![替代文字](鏈接地址) ![替代文字](鏈接地址 "title屬性")

    其中[替代文字]是指當(dāng)圖片加載不出來時顯示的替代文字以提高文章的可讀性,例如:

    ![Aaron Swartz](http://pic.baike.soso.com/p/20130113/20130113123158-66539251.jpg "Markdown 開發(fā)組帥哥 Aaron Swartz")![這就是一張裂掉的圖(╬ ̄皿 ̄)凸](nothing)

    圖片的參考式插入和鏈接的參考式是一樣的,我就不做過多的贅述了。

    想必大家也發(fā)現(xiàn)了,由于 Markdown 是純文本語言,里面是不可能真的插入一張照片的,除非使用工具(后文會介紹)直接拖拽圖片進(jìn)來,否則我們還需要借助圖床來插入圖片,下面為大家推薦幾個好用的圖床:

    • 七牛云存儲 - 國內(nèi)大公司云空間,各網(wǎng)速度都挺快
    • https://t.williamgates.net - 簡單好用,速度看網(wǎng)絡(luò)
    • Photo Bucket - 據(jù)說是BBC官方圖床

    自動鏈接

    Markdown 提供了一種快捷方式「自動地」定義鏈接和 E-mail 地址:直接用一對尖括號把 URL 或 E-mail 地址包住。這表示鏈接文本就是 URL 本身,E-mail 文本就是 E-mail 本身。這樣你就得到了一個可點(diǎn)擊的鏈接,如:

    <http://example.com/>

    自動 E-mail 地址工作方式相似,只有一點(diǎn)不同。Markdown 自動的用一些十進(jìn)制和十六進(jìn)制數(shù)字表示你的 E-mail,以防止遭遇垃圾郵件襲擊。 例如:

    <address@example.com>

    會被轉(zhuǎn)換為:

    <a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

    瀏覽器會將它渲染為一個可點(diǎn)擊的鏈接,并正確顯示 address@example.com。

    這種實(shí)體編碼的小方法可以騙過一些收集郵件地址的機(jī)器人,不過它確實(shí)無法騙過所有的機(jī)器人。有總比沒有強(qiáng),聊勝于無。能阻止一點(diǎn)就阻止一點(diǎn)好了。

    反斜杠

    Markdown 可以利用 \ 反斜杠來插入一些在語法中有其它意義的符號,例如:如果你想要用星號加在文字旁邊的方式來做出強(qiáng)調(diào)效果,你可以在星號的前面加上反斜杠:

    \*我只想用星號來強(qiáng)調(diào)這段內(nèi)容\*

    我只想用星號來強(qiáng)調(diào)這段內(nèi)容

    Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

    • \ 反斜杠
    • * 星號
    • _ 下劃線
    • {} 花括號
    • [] 方括號
    • () 園括號
    • # 井號
    • + 加號
    • - 減號
    • . 英文句點(diǎn)
    • ! 敢嘆號
    • `反引號

    Markdown 進(jìn)階語法

    為適應(yīng)更多更復(fù)雜的描述,尤其是理工科文字工作者的編輯需求,Markdown 語言擴(kuò)展出了 MultiMarkdown ,簡稱 MMD。MMD有更多的標(biāo)識,使得 Markdown 的「描述」能力大大增強(qiáng)。(以下介紹的語法并非所有的解釋器都能識別,但肯定也會逐漸得到廣泛認(rèn)可)

    錨點(diǎn)鏈接

    錨點(diǎn)是 HTML 文檔內(nèi)部鏈接的一種形式,既然 Markdown 繼承于 HTML,是它的一個子集,那應(yīng)該對錨點(diǎn)也是支持的,所以我們可以使用

    <a id="name"></a>

    代碼在文檔的任意一處設(shè)置錨點(diǎn),然后將

    [鏈接文字](鏈接地址) [鏈接文字](鏈接地址 "title屬性")

    中的 (鏈接地址) 改為相應(yīng)的 (#name) 即可。例如:

    我在前面「圖片」的那個小節(jié)設(shè)置了一個 id="photo" 的錨點(diǎn),那么下面的代碼將會成功的鏈接那個錨點(diǎn):

    [如何在 Markdown 中插入圖片](#photo)

    如何在 Markdown 中插入圖片

    LaTeX 公式2

    LaTeX 的數(shù)學(xué)公式主要有兩種,即行內(nèi)公式(Inline Formulas)和塊級公式(Display Formulas)。行內(nèi)公式內(nèi)嵌于正文文本中間,與正文文字行高相等;塊級公式則單獨(dú)成行。

    行內(nèi)公式

    用$...$符號包圍的 LaTeX 代碼,例如:

    這樣的代碼可以生成如`$x^n+y^n=z^n$`這樣的行內(nèi)公式。

    這樣的代碼可以生成如\(x^n+y^n=z^n\)這樣的行內(nèi)公式。

    塊級公式

    用$$...$$符號包圍的 LaTeX 代碼:

    這樣的代碼可以生成如`$$x=\dfrac{-b\pm\sqrt{b^2-4ac}}{2a}$$`這樣的塊級公式。

    這樣的代碼可以生成如\[x=\dfrac{-b\pm\sqrt{b^2-4ac}}{2a}\]這樣的塊級公式。

    對理工科的同學(xué)而言,LaTeX 公式的插入是一個非常值得探討的話題,我在另一篇文章《Markdown 下 LaTeX 公式、編號、對齊》中做了深入的介紹,感興趣的讀者可以打開看看。

    表格

    表格是純文本格式文字比較難以表達(dá)的一個部分,Markdown 在這一點(diǎn)上做的也不是非常出彩,下面的例子是一個表格繪制語法的展示:

    | 項(xiàng)目 | 價格 | 數(shù)量 | | -------- | -----: | :----: | | 計(jì)算機(jī) | $1600 | 5 | | 手機(jī) | $12 | 12 | | 管線 | $1 | 234 | 項(xiàng)目價格數(shù)量
    計(jì)算機(jī)$16005
    手機(jī)$1212
    管線$1234

    表格由表頭和表項(xiàng)組成,用 |---|符號組隔開即可,其中 |:--| 表示表項(xiàng)左對齊, |:--:| 表示表項(xiàng)居中對齊,|--:| 表示表項(xiàng)右對齊。

    刪除線

    使用 ~~ 包圍文本表示刪除線,例如:

    ~~這是一段錯誤的文本。~~

    這是一段錯誤的文本。

    注腳

    使用 [^keyword] 表示注腳,在文章的任意位置輸入 [^keyword]: 腳注內(nèi)容 可以在文章最后生成注腳。

    這是一個注腳[^footnote]的樣例。這是第二個注腳[^footnote2]的樣例。[^footnote]: 這是一個*注腳*的**文本**。[^footnote2]: 這是另一個*注腳*的**文本**。

    這是一個注腳[^footnote](https://kchen.cc/2015/10/05/Markdown-Manual/%E8%BF%99%E6%98%AF%E4%B8%80%E4%B8%AA%E6%B3%A8%E8%84%9A%E7%9A%84%E6%96%87%E6%9C%AC%E3%80%82)的樣例。

    這是第二個注腳[^footnote2](https://kchen.cc/2015/10/05/Markdown-Manual/%E8%BF%99%E6%98%AF%E5%8F%A6%E4%B8%80%E4%B8%AA%E6%B3%A8%E8%84%9A%E7%9A%84%E6%96%87%E6%9C%AC%E3%80%82)的樣例。

    流程圖

    st=>start: 開始 e=>end: 結(jié)束 op=>operation: 問你個事兒 cond=>condition: 這篇文章寫的好么st->op->cond cond(yes)->e cond(no)->op st=>start: 開始 e=>end: 結(jié)束 op=>operation: 問你個事兒 cond=>condition: 這篇文章寫的好么st->op->cond cond(yes)->e cond(no)->op

    以及時序圖:

    李雷->韓梅梅: 韓梅梅,你現(xiàn)在好嗎,他好嗎? Note right of 韓梅梅: 遲疑了一會兒 韓梅梅-->李雷: 我很好,他也很好! 你呢,你還好嗎,她好嗎? Note left of 李雷: 頓了頓 李雷->韓梅梅: 我很好,她剛才告訴我她也很好。 Note right of 韓梅梅: 無語凝噎 李雷->韓梅梅: 韓梅梅,你現(xiàn)在好嗎,他好嗎? Note right of 韓梅梅: 遲疑了一會兒 韓梅梅-->李雷: 我很好,他也很好! 你呢,你還好嗎,她好嗎? Note left of 李雷: 頓了頓 李雷->韓梅梅: 我很好,她剛才告訴我她也很好。 Note right of 韓梅梅: 無語凝噎

    提示:想了解更多,請查看流程圖語法以及時序圖語法。

    內(nèi)容目錄

    在段落中填寫 `` 以顯示全文內(nèi)容的目錄結(jié)構(gòu)。

    [TOC]


    Markdown 編輯器推薦

    誠然,簡便輕巧的 Markdown 語言只需要一個小小的記事本或者文本編輯就可以輕松勝任,但正所謂「工欲善其事,必先利其器」,「好馬還需好鞍配」,Markdown 如果配上一個強(qiáng)大的編輯器,那肯定會讓自己感到舒心,讓編輯工作事半功倍。

    什么樣的編輯器才是一個好的編輯器呢?

    首先,作為一門「標(biāo)記型語言」,最重要的就是能夠?qū)崟r查看自己的「標(biāo)記」效果是否正確。所以,「分屏顯示,同屏滾動」是一款優(yōu)秀編輯器的基本功能。其次,能對 Markdown 的語法有良好的支持,盡可能支持最新的擴(kuò)展語法。然后,便是界面、操控、性能、特性等等一堆需要關(guān)心的東西,下面我們就來看看哪些編輯器榮登我的推薦榜。

    馬克飛象

    馬克飛象是一款專為印象筆記(Evernote)打造的 Markdown 編輯器,通過精心的設(shè)計(jì)與技術(shù)實(shí)現(xiàn),配合印象筆記強(qiáng)大的存儲和同步功能,帶來前所未有的書寫體驗(yàn)。

    雖說馬克飛象是專為印象筆記而設(shè)計(jì),但是對于平常 Markdown 文檔的書寫而言,也絕對是編輯器中的佼佼者。它有非常多的優(yōu)點(diǎn):

    • 支持離線:在線的 Markdown 編輯器有很多,大多都功能完備,制作精良,但是需要聯(lián)網(wǎng)才能打開不免讓人覺得有時候沒網(wǎng)只能干著急?,F(xiàn)在,在電腦有 Chrome 瀏覽器的情況下,馬克飛象已經(jīng)可以作為離線應(yīng)用下載了。
    • 語法豐富:支持高亮代碼塊,自動識別代碼語言;插入豐富的 LaTeX 公式,是理工科同學(xué)工作學(xué)習(xí)好幫手;其還支持 [toc] 目錄自動生成、html 語言擴(kuò)展和注腳等眾多 MultiMarkdown 擴(kuò)展。
    • 得心應(yīng)手:支持便捷的插入圖片助手,無論是本地上傳/圖片URL/拖放圖片/直接截圖粘貼,隨心所欲。
    • 界面美觀:作為一名顏控,我不得不說馬克飛象的界面非常美觀。分屏編輯時,兩邊屏幕都是滾屏關(guān)聯(lián)的,左邊的源碼會根據(jù)輸入的標(biāo)記語言自動變換樣式,配色多樣;右邊的預(yù)覽窗口可以試試看到文檔的渲染效果,其渲染的 CSS 樣式大方得體,淡雅清麗,非常耐看。當(dāng)然你也可以手動更改 CSS 樣式,調(diào)整出你最喜歡的渲染效果。
    • 深度整合:支持選擇筆記本和添加標(biāo)簽,支持從印象筆記跳轉(zhuǎn)編輯,輕松管理。這是馬克飛象的主打特色,就是和印象筆記的雙向同步功能。不管是在國內(nèi)還是國際上,印象筆記3(Evernote International)都是非常主流的筆記管理工具。值得一提的是中文版馬克飛象能與印象筆記和 Evernote 綁定,同步筆記是其 Premium 功能,年功能費(fèi)79元。國際版 Marxico 只能綁定 Evernote,但是同步筆記功能免費(fèi)。
    • 多樣導(dǎo)出:馬克飛象支持文檔導(dǎo)出為 Markdown 的 .md 格式(純文本),HTML 的 .html 格式(可以用任何一款主流瀏覽器打開),以及出版物發(fā)行文檔 .pdf 格式。
    • 美中不足:我想想,代碼區(qū)塊在某些情況下標(biāo)識不合理,比如代碼區(qū)塊內(nèi)的 LaTeX 代碼。代碼區(qū)塊不支持行號,你可以自己用 CSS 修改。

    作業(yè)部落 - CMD Markdown

    CDM Markdown是大神@ghoster和他的團(tuán)隊(duì)開發(fā)的一款在線 Markdown 編輯器。

    歡迎使用 Cmd - 在線 Markdown 編輯閱讀器

    我們理解您需要更便捷更高效的工具記錄思想,整理筆記、知識,并將其中承載的價值傳播給他人,Cmd Markdown 是我們給出的答案 —— 我們?yōu)橛涗浰枷牒头窒碇R提供更專業(yè)的工具。

    您可以使用 Cmd Markdown:

    • 整理知識,學(xué)習(xí)筆記
    • 發(fā)布日記,雜文,所見所想
    • 撰寫發(fā)布技術(shù)文稿(代碼支持)
    • 撰寫發(fā)布學(xué)術(shù)論文(LaTeX 公式支持)

    基本上馬克飛象擁有的功能,除了馬克飛象主打的與印象筆記同步之外,它都有了,而與馬克飛象不同的是:

    • 更加完善的代碼高亮系統(tǒng),識別更精準(zhǔn),排版更漂亮,而且支持行號。
    • 帶有社交屬性的發(fā)布與分享系統(tǒng)。CDM Markdown 是作者的網(wǎng)站作業(yè)部落的一個編輯工具,所以你編輯的文稿都會儲存在作業(yè)部落的服務(wù)器上,為了保障數(shù)據(jù)安全,CMD Markdown 會將你每一次擊鍵的內(nèi)容保存至云端,你無需擔(dān)心瀏覽器崩潰,機(jī)器掉電或者地震,海嘯——在編輯的過程中隨時關(guān)閉瀏覽器或者機(jī)器,下一次回到 CMD Markdown 的時候繼續(xù)寫作。同時,你的思想和知識可以通過這個平臺,連同優(yōu)質(zhì)的閱讀體驗(yàn),將他們分享給有相同志趣的人,進(jìn)而鼓勵更多的人來到這里記錄分享他們的思想和知識。
    • 在網(wǎng)絡(luò)環(huán)境不穩(wěn)定的情況下記錄文字一樣很安全!在你編輯文檔的時候,如果電腦突然失去網(wǎng)絡(luò)連接,CMD Markdown 會智能切換至離線模式,將您后續(xù)鍵入的文字保存在本地,直到網(wǎng)絡(luò)恢復(fù)再將他們傳送至云端,即使在網(wǎng)絡(luò)恢復(fù)前關(guān)閉瀏覽器或者電腦,一樣沒有問題,等到下次開啟 CMD Markdown 的時候,它會提醒你將離線保存的文字傳送至云端。
    • 文章可以和別人協(xié)同編輯,以自然的方式讓別人進(jìn)行批注

    較為遺憾的是,由于開發(fā)時間還短,CMD Markdown 也有許多不盡如人意的地方,例如:

    • 并沒有離線的客戶端
    • .pdf 和 .html 導(dǎo)出還是亂碼

    我和作者@ghoster聯(lián)系后,@ghoster告訴我說,這些功能都在做了,很快就會更新面世,所以,讓我們好好期待吧!

    簡書

    簡書是一個將寫作與閱讀整合在一起的網(wǎng)絡(luò)產(chǎn)品。旨在為寫作者打造最優(yōu)秀的寫作軟件 ,為閱讀者打造最優(yōu)雅的閱讀社區(qū)。

    簡書的中文排版效果非常好,與作業(yè)部落不相伯仲,文本顏色更加豐富。研究表明,在淡黃色的背景下閱讀深藍(lán)色或黑色的文字讓人的眼睛覺得最舒適,這就是簡書。

    簡書的強(qiáng)大還在于它超級強(qiáng)大的的版本管理,你每一次的文檔保存都會被記錄,你可以回到文檔的任一個版本,徹底告別 v1.0 v2.0 v3.0 的時代。而且,你所有的文檔只需要一鍵就可以打包下載到本地,儲存為 .md 文檔。

    簡書還提供了十分強(qiáng)大博客和社交的功能,上面聚集了成千上萬的優(yōu)秀作者。

    不過,簡書對于理工科的公式、代碼輸入,還有許多 MultiMarkdown 并不是很支持。所以如果你是一名文科文字編輯者,輕巧簡便,淡雅脫俗的簡書就是你的不二選擇!

    終端軟件

    剛才介紹的編輯器都是在線編輯器,下面再給大家推薦幾款終端編輯器:

    • Mou - 一個 Mac OS X上的Markdown編輯器。
    • MacDown - Mac OS X 上的 Markdown 開源編輯器,作者稱其深受 Mou 啟發(fā)。
    • MarkdownPad - Windows上的全功能 Markdown 編輯器。
    • Haroopad - Linux 上的優(yōu)秀 Markdown 編輯器。

    這些軟件在終端都有完善的功能和不錯的表現(xiàn),大家可以根據(jù)自己的平臺選擇,作為「記事本」和「文本編輯」的替代也是相當(dāng)不錯的。

    至于移動端,由于屏幕大小受到限制,我認(rèn)為使用系統(tǒng)自帶的「文本編輯器」就可以了,并不需要特別的工具。


    結(jié)語

    花了幾個日日夜夜的功夫,終于把這篇文章寫完了,其間為了找參考資料和構(gòu)思全文布局,花了不少時間和心思。希望這篇文章可以幫到大家,帶大家走進(jìn) Markdown 的世界。如果大家有什么問題的話,可以到我的微博給我留言,也可以給我寫 E-mail。最后,希望喜歡這篇文章的朋友多多轉(zhuǎn)載。謝謝大家耐心看完!(看到這里的都是真愛

    微博:@悅?cè)A
    郵箱:quentin.chen@foxmail.com


    參考

    Markdown - John Gruber - Daring Fireball
    Markdown - 維基百科
    Markdown 語法說明 (簡體中文版) - Wow!Ubuntu
    Markdown 語法 - shukebete - 圖靈社區(qū)
    Markdown 寫作淺談 - 陽志平
    Markdown - Macin Chen
    為什么作家應(yīng)該用 Markdown 保存自己的文稿 - Lawrence Li
    獻(xiàn)給寫作者的 Markdown 新手指南 - 簡書
    Cmd Markdown 簡明語法手冊
    如何創(chuàng)建和鏈接到 Multimarkdown 命名錨 - CodeGo
    Markdown 編輯器之比較 - 懷瑾握瑜


  • Aaron Swartz,1986年11月8日-2013年1月11日,一位程序員、作家、政治組織策劃人和積極行動主義者。他年僅14歲就參與創(chuàng)造RSS 1.0規(guī)格,因而在程式設(shè)計(jì)圈當(dāng)中聲名大噪。2011年7月19日他被指控自 JSTOR 非法下載大量學(xué)術(shù)期刊文章,并遭聯(lián)邦政府起訴被捕,因而獲得主流媒體關(guān)注。Swartz 是 Demand Progress 和 Progressive Change Campaign Committee 的共同創(chuàng)辦人。他曾住在美國馬薩諸塞州的劍橋,于2013年1月11日自殺。?

  • LaTeX 是一種基于 TEX 的排版系統(tǒng),由美國計(jì)算機(jī)學(xué)家萊斯利·蘭伯特(Leslie Lamport)在20世紀(jì)80年代初期開發(fā),利用這種格式,即使使用者沒有排版和程序設(shè)計(jì)的知識也可以充分發(fā)揮由 TeX 所提供的強(qiáng)大功能,能在幾天,甚至幾小時內(nèi)生成很多具有書籍質(zhì)量的印刷品。對于生成復(fù)雜表格和數(shù)學(xué)公式,這一點(diǎn)表現(xiàn)得尤為突出。因此它非常適用于生成高印刷質(zhì)量的科技和數(shù)學(xué)類文檔。這個系統(tǒng)同樣適用于生成從簡單的信件到完整書籍的所有其他種類的文檔。?

  • 印象筆記帳戶和 Evernote 國際版帳戶使用同一款軟件,但帳戶相互獨(dú)立(可以用同一個郵箱在兩邊注冊)。Evernote 國際版帳戶服務(wù)器在國外。印象筆記帳戶服務(wù)器在國內(nèi),有更快更穩(wěn)定的同步速度和更完善的用戶支持服務(wù),并專門為國內(nèi)用戶增加如收藏微信和微博等本地化功能 。?

  • posted @ 2019-01-06 17:38 YaoyaoLiu 閱讀(...) 評論(...) 編輯 收藏

    總結(jié)

    以上是生活随笔為你收集整理的【转】我们为什么要使用 Markdown的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。

    如果覺得生活随笔網(wǎng)站內(nèi)容還不錯,歡迎將生活随笔推薦給好友。