html轉markdown_Markdown與LaTeX公式的使用入門指南
技術標籤:html轉markdownlatex 加粗latex公式latex加粗latex加粗字型latex表格製作
一、Markdown是什麼?
Markdown是一種輕量級標記語言,創始人為約翰·格魯伯(英語:John Gruber)。它允許人們使用易讀易寫的純文字格式編寫文件,然後轉換成有效的XHTML(或者HTML)文件。這種語言吸收了很多在電子郵件中已有的純文字標記的特性。
由於Markdown的輕量化、易讀易寫特性,並且對於圖片,圖表、數學式都有支援,目前許多網站都廣泛使用Markdown來撰寫幫助文件或是用於論壇上發表訊息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、簡書等,甚至還能被使用來撰寫電子書^1。
相對其它文字編輯工具而言,Markdown相對html
、 都要簡單很多,但又儘可能地保留了類似專業標記語言的一些特性。由於其簡便、美觀且功能強大,目前已被廣泛用於筆記甚至於一些網路頁面的製作。
二、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|
|----|----|----|
||||
結果:
a | b | c |
---|---|---|
3、圖片
圖片一般直接貼上、拖拽即可。但特別要注意的是圖片存放的位置,一般來說可以有2種:
- 直接存在本地
- 直接使用外鏈圖片地址(不過有時可能被會遮蔽,或者可能面臨過期的情況)
4、插入程式碼
大段程式碼:
```python
#這是一段python程式碼
```
效果:
#這是一段python程式碼
5、新增腳註
新增腳註標記:[^腳註名稱]
新增腳註內容:[^腳註名稱]:(腳註內容)
示例:
6、文件目錄
markdown生成目錄非常簡單,直接在任意一行頂格敲入程式碼[TOC]
即可(“目錄”的英文是:Table of Content),比如本文的目錄:
目錄的生成是根據文字的標題級別來區分的,並且自帶頁內跳轉,使用體驗非常好。
7、與html
的相容
markdown
本身是對html
相容的,也就是說可以使用html
的程式碼來改變markdown
的樣式。比如:
- 修改文字顏色
程式碼: 這是一段紅色文字
效果:這是一段紅色文字
圖片的位置、大小也可以用html
程式碼來調整。
8、其它
其實絕大多數markdown
的語法和操作在Typora和mdnice
工具中都有對應的圖形操作方式,有這倆工具的加持,入門markdown
實際上基本無門檻。遇到特別的問題再去查詢即可。
除上述語法之外,markdown還提供了很多高階用法,比如在文字中插入音訊、視訊,像 新增參考文獻(可自動跳轉等),新增流程圖(mermaid
)功能。不過這些內容也都只有在一些比較特殊的場景才會用到,所以本文不再贅述。有興趣的同學可以自行度娘。
四、在Markdown中使用數學公式
1、基本用法
在Markdown裡使用 公式和在中使用的方法幾乎一模一樣,都是用 $ 符號來標記公式區域。
- 內聯公式
即是在文字內容中含有公式,這種公式就在公式程式碼左右兩端加上 兩個$$符號。例如:
我們初中的時候學過一元二次方程 $ax^2+bx+c=0$ 的萬能公式為$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a},\quad(\Delta\ge0)$。
我們初中的時候學過一元二次方程 的萬能公式為。
- 獨立公式
單獨起一行的公式,語法為在公式上、下兩行加上兩個$符號。例如:
$$
\int u \frac{\mathrm{d}v}{\mathrm{d}x}\,\mathrm{d}x=uv-\int \frac{\mathrm{d}u}{\mathrm{d}x}v\,\mathrm{d}x
$$
關於公式的語法直接參考媽叔文件:https://latexlive.com/help
2、高階用法
公式編號及引用。公式的引用和 的引用方式是一樣的。不同的是markdown
裡必須要加上$
符號才能表明這是一個 命令。
- 編號相對簡單,直接在公式區域中新增
\tag{1}
即可,比如:
$$
y=kx+b
\tag{1}
$$
- 公式引用則相對麻煩。簡單地說,這裡
\tag{1}
只表示給它打了一個顯示標籤,而並不代表它是一個可以被引用的位置。而真正能標記它的位置的是\label
。這裡頭的原理太多,多說也無益,直接上一個例子就能明白。
$$
y=kx+b
\tag{2}
\label{eq:linear}
$$
標記好這個公式之後,再用\eqref
命令就可以引用這個公式了。\eqref{eq:linear}
,引用效果:(2)(如果在Typora中使用,這個(2)是高亮的,點選直接跳轉到公式(2)的位置。
這個功能在自己做筆記時非常有用。不過不同的
markdown
版本不一定支援。比如像某道雲筆記就基本上不支援LATEX。
3、全世界最好用的線上免費 輔助工具
媽叔開發的線上免費 工具:https://latexlive.com/
該工具是目前全世界最好用最良心的線上 工具,沒有之一。 它的主要功能有這些:
- 線上編輯
- 下載
svg, png, pdf
圖片 - 直接轉
mathML
編碼 - 提供線上敲好的公式的線上連結
- 提供免費的
mathpix
介面,實現公式圖片轉latex
原始碼的功能
最後這個功能是最良心的功能沒有之一。Mathpix對個人賬戶每月只提供50次的免費識別服務,年卡大概也要300多RMB。但媽叔的這個工具直接幫大家承擔了所有的費用。當然他也要掛些廣告在網站上,別的不說,至少在目前為止是一點也沒有影響使用。完全免費能良心到這種程度是真的情懷!
另外,媽叔也提供了這個工具的完整介紹,有興趣可以去B站搜:如何優雅的編輯數學公式?LaTeX公式入門
綜合上述的簡單介紹,配上這個輔助工具,即便從未用過 的人應該也可以秒上手。當然如果想要長期使用 還是建議去專門學習一下。
五、Markdown與其它型別檔案的轉換
Markdown可以輕鬆地轉換為許多文件型別。目前支援最好的就是html
,而效果最差的莫過於epub
和 word
。
轉換方式非常簡單,通常我們直接使用pandoc
即可。而在Typora中只需要點選匯出,就會自動提示是否安裝pandoc
,安裝好之後直接點選轉換即可,非常方便。
另外值得一提的是,許多其它型別的檔案轉為markdown
非常輕鬆,帶來許多便利。比如jupyter notebook
的ipnb
檔案就可以直接轉為markdown
檔案,這就對我們做筆記、寫技術文件提供了極大的便利。而這個功能則直接使用nbconverter
工具即可。
寫在最後
學習工具最快的辦法就是邊用邊學,用得越多,就學得越快、學得越好!
關注我們獲得更多有趣有用的知識: