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

歡迎訪問 生活随笔!

生活随笔

當前位置: 首頁 > 编程资源 > 编程问答 >内容正文

编程问答

github pages markdown_排版利器——MarkDown入门简介

發布時間:2025/4/16 编程问答 29 豆豆
生活随笔 收集整理的這篇文章主要介紹了 github pages markdown_排版利器——MarkDown入门简介 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

[TOC]

MarkDown 是什么?

想了很久,第二篇文章寫什么好呢。這篇文章既要讓大家感興趣,又要讓大家馬上能夠用上。腦袋里搜索了好久,最后MarkDown出現了。下面引用百度百科的介紹:

Markdown 是一種可以使用普通文本編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文本內容具有一定的格式。Markdown 的語法簡潔明了、學習容易,而且功能比純文本更強,因此有很多人用它寫博客。世界上最流行的博客平臺 WordPress 和大型 CMS 如 Joomla、Drupal 都能很好的支持 Markdown。完全采用 Markdown 編輯器的博客平臺有 Ghost 和 Typecho。

看完后你可能還是一頭霧水,只知道MarkDown看上去很厲害,好多博主都用它寫文章。心里可能在想,我可沒有博主們厲害,一定學不會的。但博主們也是普通人,他們原來也是小白,很多都是通過寫博客才了解MarkDown的。但當他們熟悉了MarkDown后,沒有人再用傳統的方式寫博客了。想知道為什么他們放棄了使用這么久的寫作習慣嗎,那繼續往下看吧。我相信,你看完這一系列的文章后,你也會加入我們的隊伍的。

舉個例子

在閱讀本文之前,大家在寫作時,一般都會用 Word 或 WPS 寫作,文檔也大都以微軟的 .doc, .docx 格式儲存。還有人為了保證文檔發給誰都能正常打開,會用 .txt 格式。但是.doc 或 .docx 格式有如下問題:

  • 不一定誰都能打開。舊版的 Word 就打不開新版的 Word 文檔。
  • 對方看到的文檔的樣子和你自己看到的可能差別很大,尤其是 WPS 和 Word 之間。
  • 大部分人電腦上的 Office 都是盜版的,使用時很容易出問題。
  • 用.txt 寫的文檔沒有格式,這就給編輯你文檔的人帶來困擾了。
  • 可能有的人會說,將 Word 文檔轉成 .pdf 格式不就就解決了嗎。對,沒錯,.pdf格式文檔確實是比較完美的解決辦法。為什么說是比較完美的呢,我相信各位在生活中一定遇到過這樣的場景,需要修改 .pdf 文檔里面的內容,或者是刪除某些頁面,或者是從其他文檔里面添加新的頁面,等等等等。這個時候,.pdf 文檔的劣勢就出現了,對于一般人來說,這會很麻煩,.pdf 不像 .docx 或者 .txt 文件一樣,可以輕易地修改,它需要專門的軟件來處理。但 .pdf 文檔又有特別多的優點,比如閱讀方便、特別適合打印、特別適合屏幕上閱覽、加密特性等等,那有沒有什么格式的文檔既能有 .txt 文檔一樣方便打開,又能像 .docx 文檔一樣便于調節格式,還能特別方便地轉化成 .pdf 文檔呢。

    MarkDown 閃亮登場

    首先,千萬不要被「標記」、「語言」嚇到,MarkDown 的語法十分簡單,常用的標記符號不超過十個,用于日常寫作記錄綽綽有余,不到半小時就能完全掌握。但就是這十個不到的標記符號,卻能讓人優雅地沉浸式記錄,專注內容而不是糾結排版,達到「心中無塵,碼字入神」的境界。

    MarkDown 的優點

    說了這么多,那MarkDown格式的文檔相較于其他格式的文檔到底有什么優點呢。

  • 純文本,所以兼容性極強,可以用所有文本編輯器打開。
  • 兼顧了「什么人都能打開」和「樣式」兩個方面。MarkDown 就是純文本,就是 .txt,所以什么人都能打開。而如上所述,你可以用它來標記文本的樣式,而且語法非常簡單。
  • 由于是純文本格式,Markdown 文稿也不會因為未來軟件升級而產生不同版本之間的兼容問題,即,不會出現「我這篇稿子是用舊版 Word 寫的,你用新版 Word 看可能格式會有點問題」的情況。
  • 讓你專注于文字而不是排版。
  • 格式轉換方便。MarkDown 的文本格式為 .md,你可以輕松地將 .md 轉換為 .html、.pdf 等。
  • MarkDown 轉 HTML 非常方便。HTML 是整個萬維網(web)的標記語言,但更重要的是,它也是目前主流電子書格式所用的標記語言。無論是 .epub,.mobi,還是 Kindle 用的專有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你寫的是書,用 MarkDown 標注格式之后,可以很方便地轉為以上格式(當然這個轉換工作不需要由你來做);如果你寫的是單篇的文章(例如論文或者報告),未來也不排除結集出書的可能。若采用 MarkDown,對于日后的文件轉換工作也大有裨益。
  • 如何開始用 MarkDown?繼續用你習慣的寫作軟件即可。記事本、Word、Pages 都沒問題,但請記得存成純文本格式。就這么簡單。
  • MarkDown 的標記語法有極好的可讀性。
  • MarkDown 的缺點

    MarkDown 好像沒有啥缺點,我至今還沒發現。如果說真要有的話,可能是沒有Word那樣支持特別多的格式。什么意思呢,比如你想要修改某些字的顏色,標準的MarkDown語法是不支持的,當然,這是可以解決的,就是引入HTML的語法了。不過我感覺沒有必要,因為,大家用MarkDown寫作一般都是為了記筆記,日記這些東西,并不需要很多格式,而需要的是提供一個安靜寫作的場景,在這個場景里你不必為了排版而經常打斷你的思緒。 我相信,很多人看到這篇文章是為了論文排版。博主我曾經也嘗試過用MarkDown+R的方式排版過論文,不過,排出來的效果并不如Word排出來的符合論文標準。如果,大家想排出一份漂亮的科技論文,我在這里向大家隆重推出排版界的王者,LaTex。后面我也會出LaTex系列的文章和論文模板的。 回到正題,雖然沒有任何一個事物是完美的,也沒有任何一個軟件可以完成你所有的需求,但是如果你想找一個適合快速寫作的軟件,或者說是語法,那么MarDown絕對是你的不二之選。

    MarkDown 的基礎語法

    聽完這么多,是不是特別想學習呢。那話就不多說,下面正式開始我們的學習之旅。不過要注意一點的是,你自己做出來的效果可能和我不一樣,這是因為我們采用了不同的主題,或者說是不同的 CSS 樣式表所導致的。這一些內容,會在后面的教程里談到的。

    標題

    這是最為常用的格式,在平時常用的的文本編輯器中大多是這樣實現的:輸入文本、選中文本、設置標題格式。而在 MarkDown 中,你只需要在文本前面加上 # 即可,同理、你還可以增加二級標題、三級標題、四級標題、五級標題和六級標題,總共六級,只需要增加 # 即可,標題字號相應降低。MarkDown 支持 6 種級別的標題,對應 HTML 標簽 h1 ~ h6。l例如:

    # h1 ## h2 ### h3 #### h4 ##### h5 ###### h6

    注:# 和標題之間建議保留一個字符的空格,這是最標準的 MarkDown 寫法。以上標記效果如下:(為了不破壞本文的結構,采用圖片的形式進行展示。采用 Typora 的 Pyxill 主題進行渲染。)

    除此之外,Markdown 還支持另外一種形式的標題展示形式,其類似于 Setext 標記語言的表現形式,使用下劃線進行文本大小的控制

    這是一級標題 === 這是二級標題 ---

    以上標記效果如下:(為了不破壞本文的結構,采用圖片的形式進行展示。采用 Typora 的 Pyxill 主題進行渲染。)

    這種處理方式在 Github 的一些開源工程上面比較常見,顯而易見的缺點是:文字大小控制級別有限。

    段落及區塊引用

    需要記住的是,MarkDown 其實就是一種易于編寫的普通文本,只不過加入了部分渲染文本的標簽而已。其最終依然會轉換為 html 標簽,因此使用 MarkDown 分段非常簡單,將你要分段的部分前后至少保留一個空行即可。 而另外一個比較常見的需求就是,我們可能希望對某段文字進行強調處理。Markdown 提供了一個特殊符號 > 用于段首進行強調,被強調的文字部分將會高亮顯示。例如:

    > 如果你不相信努力和時光,那么時光第一個就會辜負你。不要去否定你的過去,也不要用你的過去牽扯你的未來。不是因為有希望才去努力,而是努力了,才能看到希望。

    其顯示結果如下:

    如果你不相信努力和時光,那么時光第一個就會辜負你。不要去否定你的過去,也不要用你的過去牽扯你的未來。不是因為有希望才去努力,而是努力了,才能看到希望。

    注1:聰明的你可能已經發現了,上面顯示的引用效果和文章開頭引用百度百科的效果是一樣的。沒錯,本站所有文章均采用 MarkDown 語法寫作,而且大家在評論時也可以采用 MarkDown 語法進行評論。這也是為什么第二篇文章為什么寫 MarkDown 的原因之一了。至于我渲染出來的結果為什么跟你不一樣,這是因為我們采用了不同的 CSS 進行調節,這一內容會在后面的高級教程進行講解。 注2:引用完后,一定記得空出一行再寫其他東西,不然,你接下來寫作的內容也都在引用內容里。 注3:> 與你要引用的文字之間一定有一個空格,不然會被認為是普通的文本。> 前面不能有文字,必須單獨一行才能引用(比如這樣,只會被認為是普通文本)。

    目錄

    MarkDown引入目錄非常簡單,只需要在你想加入目錄的地方輸入 [TOC] 就可以了。

    首行縮進方法

    在中文書寫時我們通常習慣段首縮進兩個字,但是使用 MarkDown 編輯時我們手打空格縮進是不起效果的,因此我們需要通過使用 HTML 中的空格實體來幫助我們實現縮進效果。 為了讓本文不那么難以理解,這一部分我只打算講一個,也是我比較推薦的一個, (因為網站顯示原因,所以才這么寫的。大家一定要記住分號是英文分號,而不是中文分號)。 一個漢字占兩個空格大小,所以使用四個空格就可以達到首行縮進兩個漢字的效果。而一個 代表兩個空格,所以用兩個 就代表兩個漢字、四個空格了。

    換行

    在 MarkDown 之中我們會發現文字無法換行,始終集中在一行之中。這時如果需要換行那么該怎么辦呢?在這里我們可以使用 “換行標簽” </br>。例如:

    上段文字</br>下段文字

    其顯示結果如下: 上段文字
    下段文字

    分割線

    分割線可以由 * 、 - 、 _ (星號,減號,底線)這 3 個符號的至少 3 個符號表示,注意至少要 3 個,且不需要連續,有空格也可以。例如:

    *** --- ___ * * * ****

    其顯示結果如下:






    粗體和斜體

    MarkDown 的粗體和斜體也非常簡單,用** 或者__包含一段文本就是粗體的語法,用* 或者一個 _ 包含一段文本就是斜體的語法。例如:

    *始于顏值、陷于才華、忠于人品* _始于顏值、陷于才華、忠于人品_ **始于顏值、陷于才華、忠于人品** __始于顏值、陷于才華、忠于人品__

    其顯示結果如下: 始于顏值、陷于才華、忠于人品 始于顏值、陷于才華、忠于人品 始于顏值、陷于才華、忠于人品 始于顏值、陷于才華、忠于人品

    刪除線

    用~~包含一段文本就是刪除線了。例如:

    ~~請刪除我~~

    其顯示結果如下: ~~請刪除我~~

    列表

    Markdown 支持有序列表和無序列表兩種形式:

    • 無序列表使用 * 或 + 或 - 標識
    • 有序列表使用數字加. 標識,例如:1.
    * 黃瓜 * 玉米 * 茄子+ 黃瓜 + 玉米 + 茄子- 黃瓜 - 玉米 - 茄子1. 黃瓜 2. 玉米 3. 茄子1. 黃瓜 1. 玉米 1. 茄子3. 黃瓜 2. 玉米 1. 茄子

    其顯示結果如下:

    • 黃瓜
    • 玉米
    • 茄子

    • 黃瓜
    • 玉米
    • 茄子

    • 黃瓜
    • 玉米
    • 茄子

  • 黃瓜
  • 玉米
  • 茄子

  • 黃瓜
  • 玉米
  • 茄子

  • 黃瓜
  • 玉米
  • 茄子
  • 注1:有序表不用1. 2. 3. 這樣排下去,可以直接1. 1. 1. 這樣,如果以3. 開頭,如3. 2. 1. 這樣,那么結果是3. 4. 5. 。即以什么數字開頭,結果就以什么數字開頭,后面的數字可以隨便寫。如果中間要再插入一項,就不用修改整個列表的序號了。 如果需要寫多級列表,這可以用縮進的辦法實現,例如:

    1. 動物1. 哺乳動物1. 爬行動物1. 鳥類1. 其他 1. 植物1. 被子植物1. 裸子植物1. 其他

    其顯示結果如下:

  • 動物
  • 哺乳動物
  • 爬行動物
  • 鳥類
  • 其他
  • 植物
  • 被子植物
  • 裸子植物
  • 其他
  • 代辦清單 To-do List

    你可以在 MarkDown 中編寫代辦清單,相關代碼如下:

    - [x] 已完成項目1- [x] 已完成事項- [ ] 代辦事項 - [ ] 代辦項目2 - [ ] 代辦項目3

    因為某些不可知的原因,不能在正文里顯示,下面采用 Typora 的 Pyxill 主題渲染結果進行展示。

    MarkDown 的高級語法

    通過上一節的講解,我們現在已經可以進行簡單的純文字寫作了。你可能想問,MarkDown只能處理純文本嗎,那如果我想插入表格,圖片,公式等等該怎么辦。不要急,我將會在下一篇文章進行講解,點擊MarkDown高級教程即可查看。

    MarkDown 軟件推薦

    對于初學者,我推薦你使用Typora,無論是OS X系統,還是Windows系統,還是Linux系統,都有相應的版本。Typora的優點太多了,我列舉了幾點:

    • 簡潔美觀
    • 實時預覽
    • 擴展語法
    • 跨平臺
    • 免費

    點擊MarkDown 編輯器介紹了解更多優秀的工具。順手的編輯器會讓你的寫作更加絲滑,快來挑選屬于你的編輯器吧。

    MarkDown 轉 PDF

    寫完 MarkDown 后,如果我想和別人分享我的文章怎么辦呢,如果別人沒有 MarkDown 渲染的軟件又該怎么辦呢。不要急,點擊 MarkDown 轉 PDF 鏈接進行學習。

    個人網站推廣

    大家好,我正在搭建一個分享各種效率軟件的網站,這是網站主頁地址,http://www.huangpan.net

    總結

    以上是生活随笔為你收集整理的github pages markdown_排版利器——MarkDown入门简介的全部內容,希望文章能夠幫你解決所遇到的問題。

    如果覺得生活随笔網站內容還不錯,歡迎將生活随笔推薦給好友。