Markdown与 $\LaTeX$ 公式的使用入门指南
文章目錄
- 一、Markdown是什么?
- 二、Markdown編輯工具
- 三、Markdown基本語法簡介
- 1、文檔結構相關
- 2、表格
- 3、圖片
- 4、插入代碼
- 5、添加腳注
- 6、文檔目錄
- 7、與`html`的兼容
- 8、其它
- 四、在Markdown中使用數學公式
- 1、基本用法
- 2、高級用法
- 3、全世界最好用的在線免費 LaTeX\LaTeXLATE?X 輔助工具
- 五、Markdown與其它類型文件的轉換
- 寫在最后
一、Markdown是什么?
Markdown是一種輕量級標記語言,創始人為約翰·格魯伯(英語:John Gruber)。 它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉換成有效的XHTML(或者HTML)文檔。這種語言吸收了很多在電子郵件中已有的純文本標記的特性。
由于Markdown的輕量化、易讀易寫特性,并且對于圖片,圖表、數學式都有支持,目前許多網站都廣泛使用Markdown來撰寫幫助文檔或是用于論壇上發表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、簡書等,甚至還能被使用來撰寫電子書1。
相對其它文字編輯工具而言,Markdown相對html、LaTeX\LaTeXLATE?X 都要簡單很多,但又盡可能地保留了類似專業標記語言的一些特性。由于其簡便、美觀且功能強大,目前已被廣泛用于筆記甚至于一些網絡頁面的制作。
二、Markdown編輯工具
- 桌面工具:Typora
官網:https://www.typora.io/
安裝:目前提供了Windows 32位、64位和MAC OS系統的安裝文件,直接下載安裝即可。
常用配置:
1、自定義圖片保存位置
在菜單欄中依次進入文件-->偏好設置-->圖象 中提供了插入圖片時的幾種操作,一般來說建議選擇直接保存到指定路徑:
這個指定路徑最好弄一個專門的地方存放,方便自己管理。
當然也可以選擇上傳圖片,不過這個需要云服務或者是購買云空間。通常如果只是自己用的話也可以選擇直接放到GITHUB上,相關操作方法可以參考博客:https://blog.csdn.net/xiaozecheng/article/details/105197126
2、開啟內聯公式
同樣是在偏好設置中,選擇Markdown選項,再勾上:
這個操作主要是讓 $ 符號之間的latex代碼可以直接被渲染為公式,比較方便。
3、安裝Pandoc
在Typora里面這個操作非常簡單,直接點擊文件-->導出,再任選一種文件格式就會自動提示安裝Pandoc,而這時只需要點擊同意,等待安裝即可。裝好Pandoc之后就可以輕松地將自己的文檔轉換成許多其它格式了。
另外,Typora里提供的格式轉換功能只取了很少一部分非常常用的Pandoc功能,如果覺得不夠用的話還可以直接去安裝Pandoc用指令來操作,也非常簡單。
Pandoc地址:https://pandoc.org/
- 在線工具:MDNice
該工具直接在線使用:https://www.mdnice.com/
除了可以實時渲染markdown的內容之外,還提供了一些十分方便的功能:
-
支持常用快捷鍵:比如加粗、斜體等
-
自動整理代碼
-
可直接導入導出Markdown文件
-
可直接導出知乎、微信公眾號等平臺支持的格式
當然,相關的工具還有很多,但初學時不建議在工具上耗費太多時間 。
三、Markdown基本語法簡介
類似的介紹隨便度娘都能找到,所以不多細說,這里只提幾個比較重要的點:
1、文檔結構相關
標題:用#號
字體:加粗、斜體、高亮(==這是一段高亮== 這是一段高亮)
列表:無序用“-”, 有序用“數字.空格”
2、表格
語法:
| a | b | c | | ---- | ---- | ---- | | | | |結果:
3、圖片
圖片一般直接粘貼、拖拽即可。但特別要注意的是圖片存放的位置,一般來說可以有2種:
- 直接存在本地
- 直接使用外鏈圖片地址(不過有時可能被會屏蔽,或者可能面臨過期的情況)
4、插入代碼
大段代碼:
?```python # 這是一段python代碼 ?``` 效果: # 這是一段python代碼5、添加腳注
添加腳注標記:[^腳注名稱]
添加腳注內容:[^腳注名稱]:(腳注內容)
示例:
這段文字有一個腳注2。
這樣就可以實現腳注內容的跳轉。
6、文檔目錄
markdown生成目錄非常簡單,直接在任意一行頂格敲入代碼[TOC] 即可(“目錄”的英文是:Table of Content),比如本文的目錄:
文章目錄
- 一、Markdown是什么?
- 二、Markdown編輯工具
- 三、Markdown基本語法簡介
- 1、文檔結構相關
- 2、表格
- 3、圖片
- 4、插入代碼
- 5、添加腳注
- 6、文檔目錄
- 7、與`html`的兼容
- 8、其它
- 四、在Markdown中使用數學公式
- 1、基本用法
- 2、高級用法
- 3、全世界最好用的在線免費 LaTeX\LaTeXLATE?X 輔助工具
- 五、Markdown與其它類型文件的轉換
- 寫在最后
目錄的生成是根據文本的標題級別來區分的,并且自帶頁內跳轉,使用體驗非常好。
7、與html的兼容
markdown本身是對html兼容的,也就是說可以使用html的代碼來改變markdown的樣式。比如:
- 修改文字顏色
代碼:<a style='color:red'> 這是一段紅色文字 </a>
效果: 這是一段紅色文字
圖片的位置、大小也可以用html代碼來調整。
<div align=left><img src= "圖片地址" style="zoom:50%;" width=240/> </div>效果:
還有就是目錄的樣式其實也可以使用hmtl代碼的css樣式表來調整(這個說法不太專業)。不過對于沒有基礎的同學而言無非又太雞肋,所以沒有特別需求的時候也不用考慮。
8、其它
其實絕大多數markdown的語法和操作在Typora和mdnice工具中都有對應的圖形操作方式,有這倆工具的加持,入門markdown實際上基本無門檻。遇到特別的問題再去查詢即可。
除上述語法之外,markdown還提供了很多高級用法,比如在文字中插入音頻、視頻,像LaTeX\LaTeXLATE?X 添加參考文獻(可自動跳轉等),添加流程圖(mermaid)功能。不過這些內容也都只有在一些比較特殊的場景才會用到,所以本文不再贅述。有興趣的同學可以自行度娘。
四、在Markdown中使用數學公式
1、基本用法
在Markdown里使用 LaTeX\LaTeXLATE?X 公式和在LaTeX\LaTeXLATE?X中使用的方法幾乎一模一樣,都是用 $ 符號來標記公式區域。
- 內聯公式
即是在文字內容中含有公式,這種公式就在公式代碼左右兩端加上 兩個$$符號。例如:
我們初中的時候學過一元二次方程 $ax^2+bx+c=0$ 的萬能公式為$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a},\quad(\Delta\ge0)$。
我們初中的時候學過一元二次方程 ax2+bx+c=0ax^2+bx+c=0ax2+bx+c=0 的萬能公式為x=?b±b2?4ac2a,(Δ≥0)x=\frac{-b\pm\sqrt{b^2-4ac}}{2a},\quad(\Delta\ge0)x=2a?b±b2?4ac??,(Δ≥0)。
- 獨立公式
單獨起一行的公式,語法為在公式上、下兩行加上兩個$符號。例如:
$$ \int u \frac{\mathrmozvdkddzhkzdv}{\mathrmozvdkddzhkzdx}\,\mathrmozvdkddzhkzdx=uv-\int \frac{\mathrmozvdkddzhkzdu}{\mathrmozvdkddzhkzdx}v\,\mathrmozvdkddzhkzdx $$∫udvdxdx=uv?∫dudxvdx\int u \frac{\mathrmozvdkddzhkzdv}{\mathrmozvdkddzhkzdx}\,\mathrmozvdkddzhkzdx=uv-\int \frac{\mathrmozvdkddzhkzdu}{\mathrmozvdkddzhkzdx}v\,\mathrmozvdkddzhkzdx ∫udxdv?dx=uv?∫dxdu?vdx
關于LaTeX\LaTeXLATE?X公式的語法直接參考媽叔文檔:https://latexlive.com/help
2、高級用法
公式編號及引用。公式的引用和LaTeX\LaTeXLATE?X 的引用方式是一樣的。不同的是markdown里必須要加上$ 符號才能表明這是一個LaTeX\LaTeXLATE?X 命令。
- 編號相對簡單,直接在公式區域中添加\tag{1}即可,比如:
y=kx+b(1)y=kx+b \tag{1} y=kx+b(1)
- 公式引用則相對麻煩。簡單地說,這里\tag{1}只表示給它打了一個顯示標簽,而并不代表它是一個可以被引用的位置。而真正能標記它的位置的是\label。這里頭的原理太多,多說也無益,直接上一個例子就能明白。
y=kx+b(2)y=kx+b \tag{2} y=kx+b(2)
標記好這個公式之后,再用\eqref命令就可以引用這個公式了。\eqref{eq:linear},引用效果: (2)。(如果在Typora中使用,這個(2)是高亮的,點擊直接跳轉到公式(2)的位置。
這個功能在自己做筆記時非常有用。不過不同的markdown版本不一定支持。比如像某道云筆記就基本上不支持LATEX公式。而目前絕大多數博客平臺基本都不支持這種文內公式引用,很討厭。
3、全世界最好用的在線免費 LaTeX\LaTeXLATE?X 輔助工具
媽叔開發的在線免費LaTeX\LaTeXLATE?X 工具:https://latexlive.com/
該工具是目前全世界最好用最良心的在線 LaTeX\LaTeXLATE?X 工具,沒有之一。 它的主要功能有這些:
- 在線編輯LaTeX\LaTeXLATE?X
- 下載svg, png, pdf圖片
- 直接轉mathML編碼
- 提供在線敲好的公式的在線鏈接
- 提供免費的mathpix接口,實現公式圖片轉latex源碼的功能
最后這個功能是最良心的功能沒有之一。Mathpix對個人賬戶每月只提供50次的免費識別服務,年卡大概也要300多RMB。但媽叔的這個工具直接幫大家承擔了所有的費用。當然他也要掛些廣告在網站上,別的不說,至少在目前為止是一點也沒有影響使用。完全免費能良心到這種程度是真的情懷!
另外,媽叔也提供了這個工具的完整介紹,有興趣可以去B站搜:如何優雅的編輯數學公式?LaTeX公式入門
綜合上述的簡單介紹,配上這個輔助工具,即便從未用過 LaTeX\LaTeXLATE?X 的人應該也可以秒上手。當然如果想要長期使用 LaTeX\LaTeXLATE?X 還是建議去專門學習一下。
五、Markdown與其它類型文件的轉換
Markdown可以輕松地轉換為許多文檔類型。目前支持最好的就是html,而效果最差的莫過于epub和 word。
轉換方式非常簡單,通常我們直接使用pandoc即可。而在Typora中只需要點擊導出,就會自動提示是否安裝pandoc,安裝好之后直接點擊轉換即可,非常方便。
另外值得一提的是,許多其它類型的文件轉為markdown非常輕松,帶來許多便利。比如jupyter notebook 的ipnb文件就可以直接轉為markdown文件,這就對我們做筆記、寫技術文檔提供了極大的便利。而這個功能則直接使用nbconverter工具即可。
寫在最后
學習工具最快的辦法就是邊用邊學,用得越多,就學得越快、學得越好!
(以上內容來自百度百科) ??
(這是“這段文字有一個腳注”的腳注內容) ??
總結
以上是生活随笔為你收集整理的Markdown与 $\LaTeX$ 公式的使用入门指南的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 说说牛顿迭代 -- 方法篇
- 下一篇: autograd库测试笔记-(一个基于N