0 Posted 2020-06-26Updated 2023-12-30others / Blog / Yuque12 minutes read (About 1731 words)

为什么我要使用瓦雀| markdown 语法大全

为什么我要使用瓦雀

爲什麼使用瓦雀

瓦雀是官方又推薦的一個，三方開源程序。方便本地管理，編輯，下載，上傳markdown語法的文件具體可以看官方文檔

哪些人適合使用瓦雀

想要在本地直接備份，想類似git一樣管理自己的筆記
希望在本地用markdown語法編輯記錄
希望用自己喜歡的編輯器的人
希望自由插入html語法(部分)的人
希望可以方便存入其他庫備份的人(比如, 百度雲, github)
喜歡用代碼畫流程圖的人

不適合人羣

不熟悉markdown語法的人
不會用代碼畫流程圖/腦圖
討厭命令行的人

Markdown 語法雖然輕量, 但是足夠強大. 不過, 語雀, GIthub等, 並不是就能完美支持markdown和html的所有語法. 因此, 還請跟具自己的實際情況來選擇個人所需.

使用方式

詳情點擊

安裝

sudo npm i -g waque

登錄

waque login

這個時候彈出一張網頁, 掃碼登錄授權就好

初始化配置

創建一個文件夾(倉庫), 進入後,初始化

waque init

選擇一個 Repository

使用

然後就可以通過waque export下載本倉庫所有的文本通過waque export ***.md 便可以上傳同步筆記了!
注意: 直接編輯文檔並上傳, 會出現:

✖  error     更新 安卓手机 Turmux 搭建博客[is3vdm]
{ status: 400,
  message: '抱歉，语雀不允许通过 API 修改 Lake 格式文档，请到语雀进行操作。' }

只需要去網頁上, 把該文檔刪除, 然後就可以上傳了.

已知問題

大部分和簡書顯示類似: 择势勤 2019^[1]

在语雀無法使用(hexo 可以):

腦圖;流程圖等語法
<details>或region 摺疊標籤
html 的 height 屬性
<font-size="100px"> style font-size 無效
<font></font> font 屬性標籤
<i>
<p style="...">
代碼摺疊

可

文字

註釋[\\]:# <div style='display: none'>
<img> 標籤
<div align=right> 排版標籤
这是*倾斜*的文字 这是倾斜的文字
这是**加粗**的文字 这是加粗的文字
这是 ***斜体加粗*** 的文字 这是 斜体加粗 的文字
这是文字^右上角^ 这是文字^右上角
这是文字~右下角~ 这是文字_右下角
这是==高亮==文字 这是高亮文字 (hexo 失效)
这是加~~删除线~~的文字 这是加~~删除线~~的文字
![图片alt](图片地址 ''图片title'')
<s><sub><sup><u><b>
flow
mermaid

字体

<font face="黑体">我是黑体字</font><br>
<font face="微软雅黑">我是微软雅黑</font><br>
<font face="STCAIYUN">我是华文彩云</font><br>
<font color=red>我是红色</font><br>
<font color=#008000>我是绿色</font><br>
<font color=Blue>我是蓝色</font><br>
<font size=5>我是尺寸</font><br>
<font face="黑体" color=green size=5>我是黑体，绿色，尺寸为5</font>

我是黑体字
我是微软雅黑
我是华文彩云
我是红色
我是绿色
我是蓝色
我是尺寸
我是黑体，绿色，尺寸为5

缩写

convert to HTML
*[HTML]: HyperText Markup Language
# Same as
<a title="HyperText Markup Language">HTML</a>

convert to HTML (hold you mouse on the HTML)
HTML

待办事项 (hexo 失效)

- [ ] item

item

- [x] item2

item2

公式 (hexo 失效)

hexo 解决办法：链接

$$
\Gamma(z) = \int_0^\infty t ^ {z-1} e ^ {-t}dt
$$

$$
\Gamma(z) = \int_0^ \infty t^ {z-1}e ^{-t}dt
$$

公式对齐：参考：芳草碧连天lc 2016

$$
\begin{equation}
\begin{aligned}
\theta ^{},\theta ^{'}&= \argmin\limits_{\theta,\theta^{{'}}\frac{1}{n}\sum_{n}}{i=1}L\left (\textbf{x}^{{(i)},\textbf{x}}{‘(i)} \right )\
&=\argmin\limits_{\theta,\theta^{{'}}\frac{1}{n}\sum_{n}}{i=1}L\left (\textbf{x}^{(i)},g_{\theta ^{’}}\left ( f_{\theta }\left ( \textbf{x}^{i}\right )\right )\right )
\end{aligned}
\end{equation}
$$

表格

|表头1|表头2|表头3|表头4|5|
|--|---------|:--|--:|:--:|
|普通|加宽|靠左对齐|靠右对齐|居中|
|普普通通|(无效))|我从左边开始|我向右看齐|我在中间|

表头1	表头2	表头3	表头4	5
普通	加宽	靠左对齐	靠右对齐	居中
普普通通	宽	我从左边开始	我向右看齐	我在中间

Tricks for 加宽无效:

|表头1|表头2|
|--|--|
|1|2<font alpha=white>aaaaaaaaaaaaaaaaaaaaaaaaaaa</font>|

表头1	表头2
1	2aaaaaaaaaaaaaaaaaaaaaaaaaaa

更多: 复杂表格 aladdin_sun 2018

Flow Chart

##flow codes for below
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: 这啥啊|invalid
cond=>condition: Yes or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2(right)->op1

Mermaid Graph

##mermaid codes for below
graph LR;
　　Portal-->|发布/更新配置|Apollo配置中心;
　　Apollo配置中心-->|实时推送|App;
　　App-->|实时查询|Apollo配置中心;

Citation: cicero 2018

graph LR;
　　Portal-->|发布/更新配置|Apollo配置中心;
　　Apollo配置中心-->|实时推送|App;
　　App-->|实时查询|Apollo配置中心;

更多mermaid例子：道隐无名 2015
七适散人 2018

Foot Note

You can create footnotes like this[^footnote].

[^footnote]: Here is the *text* of the **footnote**.

You can create footnotes like this^[2].

其他

希腊字母/角标等特殊符号

因为markdown可以使用公式插件，这些都可以用 latex 语法解决。不过也有latex，甚至是markdown自带的语法解决不了的情况。比如说， icarus 的目录就没法使用各种语法来给希腊字母，角标等。最简单的解决办法是，复制现成的。但是这个方法可能对于 plain text editor 不太友好。这里我们就可以引入实体/html 的编码来解决。网站:

案例:

A = &beta; + &psi;&sup2;

A = β + ψ²

可以发现，实体编码就是在 &和; 之间添加一些简单的语法规则。比如希腊字母的读音， sup+数字组成上标数字的情况。虽然远没latex那么强大，但是在一些小场景却更高效。经测试， hexo和语雀均支持～

html 编码全，但是几乎完全不可读。实体编码易读信高，但是东西少所以也就希腊字母等这些字母会比较实用。其他的还是用latex吧

应用场景:

latex 渲染太慢不想用。
graphviz 中的markdown 语法， latex 语法无效
标题等其他 markdown语法无效的地方

建议：大部分还是直接去网页里，复制黏贴来的快一些

择势勤; Markdown语法大全(超级版); 简书; 2019.05.02 16:37:47. ↩︎
Here is the text of the footnote. ↩︎

为什么我要使用瓦雀| markdown 语法大全

https://karobben.github.io/2020/06/26/Blog/waque/

Author

Karobben

Posted on

2020-06-26

Updated on

2023-12-30

Licensed under

为什么我要使用瓦雀| markdown 语法大全