1. 程式人生 > 其它 >html轉markdown_Markdown與LaTeX公式的使用入門指南

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、自定義圖片儲存位置

在選單欄中依次進入檔案-->偏好設定-->圖象 中提供了插入圖片時的幾種操作,一般來說建議選擇直接儲存到指定路徑:

e0473528e3f9cfa7767edf8ad8bc1dcf.png

這個指定路徑最好弄一個專門的地方存放,方便自己管理。

當然也可以選擇上傳圖片,不過這個需要雲服務或者是購買雲空間。通常如果只是自己用的話也可以選擇直接放到GITHUB上,相關操作方法可以參考部落格:https://blog.csdn.net/xiaozecheng/article/details/105197126

2、開啟內聯公式

同樣是在偏好設定中,選擇Markdown選項,再勾上:

f68d04cc51a5dd08051a7221b34701a5.png

這個操作主要是讓 $ 符號之間的latex程式碼可以直接被渲染為公式,比較方便。

3、安裝Pandoc

在Typora裡面這個操作非常簡單,直接點選檔案-->匯出,再任選一種檔案格式就會自動提示安裝Pandoc,而這時只需要點選同意,等待安裝即可。裝好Pandoc之後就可以輕鬆地將自己的文件轉換成許多其它格式了。

另外,Typora裡提供的格式轉換功能只取了很少一部分非常常用的Pandoc功能,如果覺得不夠用的話還可以直接去安裝Pandoc用指令來操作,也非常簡單。

Pandoc地址:https://pandoc.org/

  • 線上工具:MDNice

該工具直接線上使用:https://www.mdnice.com/

除了可以實時渲染markdown的內容之外,還提供了一些十分方便的功能:

  • 支援常用快捷鍵:比如加粗、斜體等

  • 自動整理程式碼

  • 可直接匯入匯出Markdown檔案

  • 可直接匯出知乎、微信公眾號等平臺支援的格式

08e84a0d3b4ae602efd2d4ff6a6800c9.gif

當然,相關的工具還有很多,但初學時不建議在工具上耗費太多時間 。

三、Markdown基本語法簡介

類似的介紹隨便度娘都能找到,所以不多細說,這裡只提幾個比較重要的點:

1、文件結構相關

標題:用#號

字型:加粗、斜體、高亮(==這是一段高亮== ==這是一段高亮==)

列表:無序用“-”, 有序用“數字.空格”

2、表格

語法:

|a|b|c|
|----|----|----|
||||

結果:

abc
3、圖片

圖片一般直接貼上、拖拽即可。但特別要注意的是圖片存放的位置,一般來說可以有2種:

  • 直接存在本地
  • 直接使用外鏈圖片地址(不過有時可能被會遮蔽,或者可能面臨過期的情況)
4、插入程式碼

大段程式碼:

```python
#這是一段python程式碼
```
效果:
#這是一段python程式碼
5、新增腳註

新增腳註標記:[^腳註名稱]

新增腳註內容:[^腳註名稱]:(腳註內容)

示例:

4ed2f81f6c4905ebc408d7412eafcc2d.png

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,而效果最差的莫過於epubword

轉換方式非常簡單,通常我們直接使用pandoc即可。而在Typora中只需要點選匯出,就會自動提示是否安裝pandoc,安裝好之後直接點選轉換即可,非常方便。

另外值得一提的是,許多其它型別的檔案轉為markdown非常輕鬆,帶來許多便利。比如jupyter notebookipnb檔案就可以直接轉為markdown檔案,這就對我們做筆記、寫技術文件提供了極大的便利。而這個功能則直接使用nbconverter工具即可。

寫在最後

學習工具最快的辦法就是邊用邊學,用得越多,就學得越快、學得越好!

關注我們獲得更多有趣有用的知識:

ea2c8b8411812aa91da2f151a8eb669b.png