GitHub Markdown語法--圖文詳解

2021-02-13 生物空間站

Markdown是一個面向網絡編寫者的文本到HTML或XHTML轉換工具。讓創作者更加專注於寫作而不是聚焦於花樣各式。親測支持Visual Studio Code, PyCharm, Typora, RStudio。

標題

Markdown的有六級標題

用』#『表示第一級標題

用』##『表示第二級標題

用』###『表示第三級標題

用』####『表示第四級標題

用』######『表示第五級標題

用『######』表示第六級標題

圖1 左邊為輸入模式,右邊為預覽模式

圖1 中可以看到從標題1到標題6字號逐漸變小,而到標題7卻沒變小。因為 Markdown只支持六級標題。因此,圖1中的標題7不是標題。推薦在輸入『#』後鍵入一個空格,雖然GitHub無論有無空格都能識別標題,但不是所有Markdown編譯器都能識別#後無空格的標題。

列表

Markdown有兩種列表,分別為①有序列表,用'阿拉伯數字'+'.'+'空格'表示;②無序列表,用'-'或'+'或'*'+'空格'表示。

圖2 左邊為輸入模式,右邊為預覽模式

圖2 中可以看出無序列表和有序列表可以相互嵌套使用,但是只能相互嵌套一次。

表格

Markdown的表格的語法看起來較為繁瑣,但是輸入起來較為方便和直觀。但是,如果想用顏色表格寬度等參數就比較複雜了,需要用到html 的<table>(目前簡書不支持)。

圖3 左邊為輸入模式,右邊為預覽模式

圖3 中第一行為表頭(表的第一行),不同列之間用'|'符號間隔。第二行為表中文字的對其方式,'-:'表示右對齊;':-:'表示居中對齊;':-'表示左對齊。

文本樣式

Markdown支持三種中文本樣式,分別是:加粗、斜體和刪除線。

文本樣式符號輸入模式輸出模式加粗** **或__ __**TP53**TP53斜體* *或_ _*TP53*TP53刪除線~~ ~~~~TP53~~TP53換行和縮進Markdown的換行

Markdown的換行一般有兩種形式:①使用html語法的</br>;②在文本後鍵入兩個空格。

圖4 左邊為輸入模式,右邊為預覽模式

圖4 中第一行和第二行代碼因為沒有</br>標籤和兩個空格,所以沒有進行換行;第四行有</br>標籤所以進行了換行;第六行和第七行因為在文本後有兩個空格,所以進行了換行。

Markdown的縮進

圖5 左邊為輸入模式,右邊為預覽模式

圖5 中第一行和第二行可以看出Markdown中在文本前鍵入空格是無法渲染出縮進效果的。因此需要一些特殊的符號進行縮進。其中,縮進一個空格(半角)的有:①&ensp;;②&nbsp;;③&#8194;;④&#160;。縮進兩個空格(全形)的有:①&emsp;;②&#8195;。

引用文本

圖6 左邊為輸入模式,右邊為預覽模式

簡書中的引用:

我是一個引用文本

引用代碼

在Markdown中引用代碼一般用頭尾的`將代碼包括起來。也有Markdown編輯器支持頭尾使用```包括代碼。也可使用兩個tab鍵後進行代碼的鍵入。

圖7 左邊為輸入模式,右邊為預覽模式

圖7 中使用了三種形式:①`;②```③    (兩個tab鍵)。在Markdown中實現代碼的輸入。

連結

引用是寫作過程中經常用到的操作,無論是文學寫作還是科學寫作。而引用的同時附加一個超連結是個十分方便的。
Markdown中的引用格式較多,本人就討論兩種使用最多的引用。

圖8 左邊為輸入模式,右邊為預覽模式

圖8 中有兩種連結語法。連結1和連結2為第一種,連結3為第二種。

參考文獻:

Github上Markdown基本語法

Markdown——入門指南

相關焦點

  • Markdown 語法快速入門
    •簡書[2]•CSDN[3]•github[4]•typora[5](建議下載非常好用)•公眾號格式化工具[6](可以收藏)•郵箱[7]還有很多,等待你的發現!要點來了,Markdown語法要怎麼用?下面是關於Markdown語法我的一些匯總:一、代碼塊1.//代碼塊語法:2.```python3.
  • 新浪圖床快速下載markdown圖片並遷移至github教程
    碎碎念本博客站的所有圖片已經從新浪圖床遷移至github了。因為從前幾天起,新浪微博的圖床開始斷斷續續的防盜鏈,時好時壞,嚴重影響體驗。於是在換到新浪圖床的時候,在github上找到了一個python備份markdown圖片的倉庫。具體可以參考python備份hexo博客圖片這篇文章。在遷移圖片的時候也是對那份代碼有所改進,代碼已推送至倉庫的debug分支markdown-img-backup。
  • 半個小時學會Markdown標記語法
    以typora為首的markdown語法完美支持各種代碼,這裡以Python代碼為例```pythonimport requestsurl = 'https://www.baidu.com/'resp = requests.get(url)```
  • R Markdown 簡介
    R Markdown文檔編輯需要 rmarkdown包,rmarkdown安裝需要RStudio編輯器環境,但是你可以以github途徑來下載rmarkdown,並安裝。devtools:install_github("rmarkdown", "rstudio")R Markdown是資原始碼豐富並高可用的文件,你可以將通過一下兩種方式改變R Markdown文件格式。
  • Markdown基礎語法
    markdown是一種輕量級標記語言,在2004年由約翰·格魯伯(英語:John Gruber)創建。markdown編寫的文檔可以導出為多種格式,如:html,word,圖片,pdf,Epub等,後綴為 .md 或者 .markdown。mar
  • 5分鐘掌握一項寫作技能,小白也能懂的簡明markdown教程
    Markdown是一種可以使用普通文本編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文本內容具有一定的格式。這些人包括經常需要寫文檔的碼農、博客寫手、網站小編、出版業人士等等 參考 百度百科markdown簡明語法開始學習markdown就有必要了解一下基本的語法,這裡羅列一些基本的語法,這些語法是非常簡單且常用的,能夠幫助你快速掌握這門輕量的標記語言並且能夠動手寫自己的小博客,動手寫起博客之後一些高級的用法可以邊用邊學
  • 常用的markdown語法
    最近學習了一個文本編輯工具Markdown,簡單了解一下其語法,通過簡單的一些語法也可以使我們的文本具有漂亮的格式顯示。個人覺得對我們筆記的記錄以及文章的發表都會帶來方便和好處。主要從以下幾點進行介紹,大家會發現很方便,加粗的是對這個語法的解釋,請不要寫入到markdown編輯器中。包括鍊表、列表、代碼塊、圖片、字體、標題等。
  • Markdown 新手入門語法
    三.Markdown官方文檔這裡可以看到官方的 Markdown 語法規則文檔,當然,後文我也會用自己的方式闡述這些語法的具體用法。四.語法入門1.標題標題是文章中常用的格式。類似於html中的<h1>到<h6>標籤,Markdown中1到6個#號來標誌1到6號標題。
  • Linux 上 10 個最好的 Markdown 編輯器
    一些卓越的特性:支持實時預覽支持導出 PDF 和 HTML支持 Github Markdown 語法支持定製 CSS支持語法高亮提供鍵盤快捷鍵高可定製性和其他SublimeText-Markdown 插件Sublime Text 是一個精心打造的、流行的、跨平臺文本編輯器,用於代碼、markdown 和普通文本。
  • 【軟體技巧】Markdown語法簡介
    在Markdown中的公式表示使用了LaTex的語法。Markdown同樣也有行間公式與行內公式的區別,以機器學習中的線性模型為例,做如下展示。[Markdown](https://www.markdownguide.org/assets/favicons/apple-touch-icon.png)[莎士比亞十四行詩](http://mp.weixin.qq.com/s?
  • 8 個優秀的開源 Markdown 編輯器
    Markdown 是由 John Gruber 和 Aaron Swartz 共同創建的一種輕量級純文本格式語法。Markdown 可以讓用戶「以易讀、易寫的純文本格式來進行寫作,然後可以將其轉換為有效格式的 XHTML(或 HTML)「。Markdown 語法只包含一些非常容易記住的符號。其學習曲線平緩;你可以在炒蘑菇的同時一點點學習 Markdown 語法(大約 10 分鐘)。
  • Markdown 開啟你更高效工作的第一步!
    ❞Markdown 基本語法關於 Markdown 基本語法的資料,在網上隨便一找就是一大把。這裡便不再贅述了。下面列舉了一些教程資源,可以看一下。其實,Markdown 語法十分簡單,主要我們掌握以下幾個就可以足以應付絕大多數的場景了。
  • 10 個 GitHub 上最火的程式設計師簡歷項目,2021 金三銀四必備!
    https://github.com/geekcompany/ResumeSample2. Markdown-Resume用 markdown 語法來寫的簡歷模版,非常簡結通用。還介紹了導出 PDF 的方法。
  • 推薦幾款好用的markdown編輯器
    Haroopad的特色是主題樣式豐富,語法高亮支持無數種程式語言,幾乎你能想到的程式語言他都支持。Ubuntu/Linux 用戶使用該工具比例很高,Haroopad 也是開源免費的。Haroopad也支持導出HTML、PDF,也支持數學公式和流程圖。
  • 專為 Gopher 準備的 Markdown 教程
    Markdown 語法相對簡單,網上隨處可以找到相關教程。因此本文不是一篇 Markdown 語法教程,而是希望通過一個 Go 語言 Markdown 解析庫的學習來更深入地了解、掌握 Markdown。如果你對 Markdown 語法了解很少,這裡有一份極簡的教程:https://studygolang.com/markdown。
  • Markdown 語法的簡要規則
    Markdown 語法的簡要規則標題一個#是一級標題 最多6級標題(也就是說最多6個#)列表
  • 打造一款基於monaco-editor及markdown-it的Markdown編輯器(上)
    前言本文的 Markdown 編輯器主要是 Monaco editor + markdown-it 實現 markdown 編輯以及預覽,目前實現了:文章複製功能;Markdown 轉 html 基本樣式;自定義 table 插件以及 h 標籤插件
  • 如果你還不會用Markdown
    Markdown使用一、介紹考慮到周圍不少同學不太了解markdown以及從未使用過markdown,這裡對markdown進行一下介紹。我平時寫公眾號文章全部是使用markdown編寫,之後使用相應的格式轉換工具排版,比起word要方便很多(當然如果word用的很熟練的話自然是不比markdown差的,我就屬於word用得不太利索的…)markdown在平時的工作生活中有很多方便的使用場景,例如做筆記,進行項目記錄,寫報告等等。
  • 終於下決心處理了將markdown編寫內容複製到百家號排版亂的問題
    前因:在發文章前,先是通過自己博客用markdown進行編寫;然後生成對應的HTML標籤複製到頭條或公眾號;然後,我記得之前在SF論壇回答過一個關於markdown相關的問答:markdown其實就是將某些特定的標籤轉化為HTML的形式所以如果是自己做,其實代碼最多的地方也只是將某些代碼片段進行正則匹配與替換,還好我打到了兩個還不錯在github開源的插件,直接down下來就好,當然是給了star