Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
wow-yes committed Apr 3, 2024
1 parent 141bd55 commit 45f817f
Show file tree
Hide file tree
Showing 5 changed files with 113 additions and 76 deletions.
12 changes: 4 additions & 8 deletions _posts/2018-01-01-Linux下我的软件列表.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ toc : true
- 主流 理由同上
- 开源 最大限度避免版权纠纷
- 跨平台 即使换了平台,也能无缝切换。

3. 慢慢研究所要使用的软件

磨刀不误砍柴工
Expand Down Expand Up @@ -64,7 +64,7 @@ toc : true
## 5. 版本管理+博客:Git/ Bitbucket&GitHub

这个组合解决了以下几个问题

1. 文件和项目的版本管理问题
2. 博客
3. 与他人的分享和交流
Expand Down Expand Up @@ -115,11 +115,7 @@ according to South Carolina Representative Trey Gowdy.""

## 15. 火狐插件

- markdown-viewer

可以直接在浏览器中查看markdown文件的显示效果,免去使用pandoc转换的麻烦。
- markdown-viewer 可以直接在浏览器中查看markdown文件的显示效果,免去使用 Pandoc 转换的麻烦。
[项目地址](https://github.com/Thiht/markdown-viewer)

- ublocks

在adblock被收购之后,很多人转向这个软件,阻挡各种流氓广告。感觉比前者好用很多。
- ublocks 在adblock被收购之后,很多人转向这个软件,阻挡各种流氓广告。感觉比前者好用很多。
161 changes: 102 additions & 59 deletions _posts/2020-12-20-Markdown.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,51 @@ toc : true
title: '我的Markdown笔记'
---

All I know about markdown.
Markdown 是一种轻量化的标记语言,可以看作是$\LaTeX$的简化版。学习 Markdown 可以方便快捷地创作包含代码、公式、结构图等内容的文档,且文档以文本格式保存。

## 在文档中引用函数使用单引号
Markdown 主要包括以下几个方面的内容

Use the `printf()` function.
- 基本语法
- 表格
- 公式
- 绘图
- 相关软件

如果只学习 Markdown 的基本语法,那么 Markdown 对于写作效率的提升是有限的。对我来说,能够在Markdown中方便快捷地绘图和书写公式更为重要。

## markdown的默认表格形式
## 基本语法

Markdown 的基本语法,可以参考官方教程 [Markdown 官方教程](https://Markdown.com.cn/)

下面记录几个容易遗忘的知识点

在文档中引用函数使用**单引号**,例如:Use the `printf()` function.

#### 代码块

Markdown 代码块可声明编程语言类型有几十种,具体可以参考:

- [Markdown 代码块可声明编程语言类型](https://www.iszy.cc/posts/15/)
- [github-linguistlinguist](https://github.com/github-linguist/linguist/blob/master/lib/linguist/languages.yml)


#### 添加脚注

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。

[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE Markdown.



---------------------------------

## 表格

Markdown 制作表格使用 `|` 来分隔不同的单元格,使用 `-` 来分隔表头和其他行。

pandoc以及其他工具支持更多的表格形式
Pandoc 以及其他工具支持更多的表格形式

```
| 表头 | 表头 |
Expand All @@ -24,23 +57,15 @@ pandoc以及其他工具支持更多的表格形式,
| 单元格 | 单元格 |
```

pandoc 生成pdf

```bash
pandoc -s --pdf-engine=xelatex --highlight-style=tango
-V CJKmainfont='WenQuanYi Micro Hei'
-V geometry:margin=.8in
-V papersize=b5 xx.md
-o test.pdf
```

参考教程

- [Markdown 表格-菜鸟教程](https://www.runoob.com/markdown/md-table.html)
- [Markdown 表格-菜鸟教程](https://www.runoob.com/Markdown/md-table.html)

## markdown中的公式
## 公式

markdown支持数学公式主要是两个JS插件MathJax和KaTeX
Markdown支持数学公式主要是两个 JavaScript 插件 MathJax 和 Katex ($\KaTeX$)

[Supported Functions · KaTeX](https://katex.org/docs/supported.html#line-breaks)

Expand All @@ -66,27 +91,13 @@ $$\Huge{F=ma}$$

$$\Huge{F=ma}$$

## markdown相关软件

浏览器插件

- Copy Selection as Markdown

- Markdown Viewer

支持的数学公式,mermaid和图表,非常不错。

下面两个插件也不错,但是没有数学公式支持
- Markdown Editor for Firefox
- Markdown Viewer Webext

**QOwnNotes不支持数学公式,忽略之**

[Latex support · Issue #529 · pbek/QOwnNotes](https://github.com/pbek/QOwnNotes/issues/529)
## 图表

> MathJax is a javascript library, we don't have a webbrowser to use it. Please see [#377](https://github.com/pbek/QOwnNotes/issues/377) and [#400](https://github.com/pbek/QOwnNotes/issues/400).
## Mermaid 实用教程
Markdown 中除了引用图片,还可以使用Mermaid绘制更为丰富的图片。

Mermaid是一个用于画流程图、状态图、时序图、甘特图的库,使用JS进行本地渲染,广泛集成于许多Markdown编辑器中。

Expand All @@ -100,9 +111,9 @@ Github 项目地址:[https://github.com/knsv/mermaid](https://github.com/knsv/

接下来介绍 Mermaid 的流程图及序列图的语法,也就是大家在工作中常使用的图表。

## 流程图
### 流程图

### 图表方向
#### 图表方向

Mermaid 支持多种图表的方向,语法如下:

Expand All @@ -120,7 +131,7 @@ graph 方向描述
| RL | 从右到左 |
| LR | 从左到右 |

## 用语转义
#### 用语转义

只支持表情,不支持公式??

Expand All @@ -129,7 +140,7 @@ graph LR
A["A double quote:#quot;"] -->B["A dec char:#9829;"]
```

### 节点定义
#### 节点定义

即流程图中每个文本块,包括开始、结束、处理、判断等。Mermaid 中每个节点都有一个 id,以及节点的文字。

Expand All @@ -154,7 +165,7 @@ graph TB
node5[(Database)]
```

### 节点间的连线
#### 节点间的连线

| 表述 | 说明 |
| --- | --- |
Expand All @@ -167,21 +178,21 @@ graph TB
| `-.-` | 虚线 |
| `-.text.-` | 虚线加文字 |

### 子图表
#### 子图表

使用以下语法添加子图表

```
```mermaid
subgraph 子图表名称
子图表中的描述语句...
end
```

### 对 fontawesome 的支持
#### 对 fontawesome 的支持

使用 `fa: # 图表名称 #` 的语法添加 fontawesome。

### 举个例子
#### 举个例子

![这里写图片描述](https://img-blog.csdn.net/2018030422354692?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZmVuZ2h1aXpoaWRhbw==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70)

Expand All @@ -195,7 +206,7 @@ graph TB
end
```

## 序列图
### 序列图

使用以下语法开始序列图

Expand All @@ -213,7 +224,7 @@ sequenceDiagram
李四->>张三: 吃了
```

### 参与者
#### 参与者

上例中的张三、李四都是参与者,上例中的语法是最简单的,也可以明显表明参与者有哪些

Expand All @@ -225,7 +236,7 @@ sequenceDiagram
participant 简称 as 参与者 3 # 该语法可以在接下来的描述中使用简称来代替参与者 3
```

### 消息线
#### 消息线

| 类型 | 描述 |
| ---- | ---- |
Expand All @@ -236,7 +247,7 @@ sequenceDiagram
| `-x` | 末端为叉的实线(表示异步) |
| `--x` | 末端为叉的虚线(表示异步) |

### 处理中
#### 处理中

在消息线末尾增加 `+` ,则消息接收者进入当前消息的“处理中”状态;
在消息线末尾增加 `-` ,则消息接收者离开当前消息的“处理中”状态。
Expand All @@ -247,7 +258,7 @@ sequenceDiagram
activate 参与者
```

### 标注
#### 标注

语法如下

Expand All @@ -263,7 +274,7 @@ Note 位置表述 参与者: 标注文字
| left of | 左侧 |
| over | 在当中,可以横跨多个参与者 |

### 循环
#### 循环

语法如下

Expand All @@ -272,7 +283,7 @@ loop 循环的条件
end
```

### 判断
#### 判断

```
alt 条件 1 描述
Expand All @@ -292,7 +303,7 @@ opt 条件描述
end
```

### 举个例子
#### 举个例子

![这里写图片描述](https://img-blog.csdn.net/20180304223610544?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZmVuZ2h1aXpoaWRhbw==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70)

Expand Down Expand Up @@ -320,25 +331,57 @@ sequenceDiagram
- [Mermaid 实用教程_平头-CSDN博客_mermaid](https://blog.csdn.net/fenghuizhidao/article/details/79440583)
- [mermaid官方教程](https://mermaid-js.github.io/mermaid/#/README)

### mermaid绘制饼图
### 饼图

```mermaid
```
pie
"Dogs" : 36
"Cats" : 85
"Rats" : 15
```

## 添加脚注
## 相关软件

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
### MathJax 和 KaTeX

[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.


## markdown软件的选择理由
### 浏览器插件

- Copy Selection as Markdown

- Markdown Viewer

支持的数学公式,mermaid和图表,非常不错。

下面两个插件也不错,但是没有数学公式支持

- Markdown Editor for Firefox
- Markdown Viewer Webext

### 专用软件

1. logseq : 存储的格式不是标准的markdown格式。
2. obsidian: 使用起来太过复杂,同步功能比较弱,但预览的确很强
1. Logseq : 存储的格式不是标准的 Markdown 格式。
2. Obsidian: 使用起来太过复杂,同步功能比较弱,但预览的确很强
3. QOwnNotes 不支持数学公式,忽略之

[Latex support · Issue #529 · pbek/QOwnNotes](https://github.com/pbek/QOwnNotes/issues/529)

> MathJax is a javascript library, we don't have a webbrowser to use it. Please see [#377](https://github.com/pbek/QOwnNotes/issues/377) and [#400](https://github.com/pbek/QOwnNotes/issues/400).
### 文本编辑器 Vim 和 VsCode



### 格式转换 Pandoc


pandoc 生成pdf

```bash
pandoc -s --pdf-engine=xelatex --highlight-style=tango
-V CJKmainfont='WenQuanYi Micro Hei'
-V geometry:margin=.8in
-V papersize=b5 xx.md
-o test.pdf
```
6 changes: 3 additions & 3 deletions _soft/001-vim.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ name : 001-vim知识总结
```mermaid
graph TD
SOFT --> git(GIT)
```

syntax on:这可以确保 Vim 知道我在使用什么语法。做笔记、写这种文章时我主要使用 Markdown; 而在写小说的时候,纯文本是我的首选格式。
Expand All @@ -19,7 +18,7 @@ set wrap:确保文本以写作者而不是程序员的方式进行折行。

从这点上来说,你的 .vimrc 是一个活的文档,它能生动地反映你想用 Vim 做什么,以及你希望 Vim 如何为你做这些事情。

```viml
```vim
syntax on
set noerrorbells " 取消 Vim 的错误警告铃声,关闭它以免打扰到我们 "
set textwidth=100 " 确保每一行不超过 100 字符 "
Expand Down Expand Up @@ -85,7 +84,8 @@ endif


vim删除文件中的所有空格
```bash

```vim
:v/./d
```

Expand Down
2 changes: 0 additions & 2 deletions _soft/999-命令行神器.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
name : 999-命令行神器
```


一些命令行工具及其进阶替代品

### icdiff
Expand Down Expand Up @@ -43,7 +42,6 @@ fdupes -r -dN

### 查找文件 find


查找当前目录下的空文件夹并且删除

```bash
Expand Down
Loading

0 comments on commit 45f817f

Please sign in to comment.