Markdown 手札

Keywords:markdown,md语法,笔记
Typora大法好!
Typora大法好!!
Typora大法好!!!

Markdown基本撰写和格式语法

标题

  • 要创建标题,请在标题文本前添加一至六个 # 符号,使用的 # 数量(1 - 6)将决定标题的大小。
#    一级标题
##   二级标题
###  三级标题
#### 四级标题
#### 五级标题
######   六级标题

补充

  • 对标题进行封闭处理(类似于html中的自闭合标签加个/标注),那么你可以对应的在标题后面加上 相应数量的"#"。
  • 一级标题和二级标题还支持另外的使用方式,就是在一级标题下面加=,二级标题下面加-(最少加一个):
  一级标题
  ===
  二级标题
  ---

分隔线
连续的三个以上的*或-或_, 你也可以在连字符或星号之间使用空格。

---
***
___
- - -

样式文本

  • 可以使用粗体、斜体或删除线文本来表示强调,粗体和斜体能够互相嵌套
样式 语法 实例
粗体 ** **__ __ 包围(无需多余空格) 粗体字
斜体 * *_ _ 包围 斜体字
上标 ^ ^ 包围 5a3b2c
下标 ~ ~ 包围 C60 是足球烯
删除线 ~~ ~~ 包围 删除线
粗体+斜体 *** *** 包围 粗体又斜体
强调 == == 包围 重要的事情说三遍
  • 下划线:Markdown 并无下划线的原生语法,因为会和链接的默认样式产生混淆。可以采用html的span标签、设置行内CSS的border-bottom属性来添加下划线:
  • e.g. span标签:所添加的需要加下划线的行内文字u标签示例
<span style="border-bottom:2px dashed yellow;">span标签:所添加的需要加下划线的行内文字</span>
<u>u标签示例</u>

引用文本

可以使用 > 来引用一段文本,引用可以多层嵌套

鲁迅:“这是一段引用文本”(我没说.jpg)

禁止套娃!

禁止禁止套娃!!

> 鲁迅:“这是一段引用文本”(我没说.jpg)
> > 禁止套娃!
> > > 禁止禁止套娃!!

代码

  • 使用单反引号` `或双反引号`` ``可标注句子中的代码或命令,反引号中的文本不会被Markdown解释器格式化,一般在文本段落中还能起突出强调的作用。

  • 要将代码或文本格式化为各自的不同块,按照不同类型的代码风格进行高亮显示,使用三反引号```[C/Java/html/..] ``` 独立分行。

    一些基本的git命令:
    git status
    git add ./
    git commit
    

    code支持的语言:1c, abnf, accesslog, actionscript, ada, apache, applescript, arduino, armasm, asciidoc, aspectj, autohotkey, autoit, avrasm, awk, axapta, bash, basic, bnf, brainfuck, cal, capnproto, ceylon, clean, clojure, clojure-repl, cmake, coffeescript, coq, cos, cpp, crmsh, crystal, cs, csp, css, d, dart, delphi, diff, django, dns, dockerfile, dos, dsconfig, dts, dust, ebnf, elixir, elm, erb, erlang, erlang-repl, excel, fix, flix, fortran, fsharp, gams, gauss, gcode, gherkin, glsl, go, golo, gradle, groovy, haml, handlebars, haskell, haxe, hsp, htmlbars, http, hy, inform7, ini, irpf90, java, javascript, json, julia, kotlin, lasso, ldif, leaf, less, lisp, livecodeserver, livescript, llvm, lsl, lua, makefile, markdown, mathematica, matlab, maxima, mel, mercury, mipsasm, mizar, mojolicious, monkey, moonscript, n1ql, nginx, nimrod, nix, nsis, objectivec, ocaml, openscad, oxygene, parser3, perl, pf, php, pony, powershell, processing, profile, prolog, protobuf, puppet, purebasic, python, q, qml, r, rib, roboconf, rsl, ruby, ruleslanguage, rust, scala, scheme, scilab, scss, smali, smalltalk, sml, sqf, sql, stan, stata, step21, stylus, subunit, swift, taggerscript, tap, tcl, tex, thrift, tp, twig, typescript, vala, vbnet, vbscript, vbscript-html, verilog, vhdl, vim, x86asm, xl, xml, xquery, yaml, zephir

  • 如果不需要代码高亮,可以用下面的方法禁用:

    ```nohighlight
    ```

链接

  • 通过将链接文本包含在方括号 [ ] 内,然后将 URL 包含在括号 ( ) 内,可创建内联链接。 还可以使用键盘快捷键 命令键 + k 来创建链接。

    本站点是使用 [GitHub Pages](https://pages.github.com/) 构建的。
    

    本站点是使用 GitHub Pages 构建的。

脚注

  • 向文章添加脚注,以上标的形式展示,脚注内容会显示在文章结尾处。
    大佬写文章总是喜欢做这样[^fn1]或那样[^fn2]的脚注。
    [^fn1]: 我也不懂。。。
    [^fn2]: 怕了怕了!!!
    
  • 大佬写文章总是喜欢做这样[1]或那样[2]的脚注。

列表

  • 无序列表:通过在一行或多行文本前面添加 +-* 后跟一个空格,可创建无序列表。

    + George Washington
    + John Adams
    + Thomas Jefferson
    
  • 有序列表:在列表前面加上数字/字母 作为编号,每个编号使用一个点+空格

    1. James Madison
    2. James Monroe
    3. John Quincy Adams
    
  • 列表(有序 or 无序)还能嵌套:通过在一个列表项下面缩进一个或多个其他列表项,可创建嵌套列表。

    要通过编辑器或使用等宽字体创建嵌套列表,可以直观地对齐列表。 在嵌套列表项的前面键入空格字符,直至列表标记字符(-*)位于其上方条目中第一个文本字符的正下方。

    1. First list item
       - First nested list item
         + Second nested list item
    
    1. First list item
      • First nested list item
        • Second nested list item

任务列表

  • 创建任务列表,在列表项目前面、列表标号[-+*]后面加一个常规 空格 字符,后接 [ ] 。若要将任务标记为已完成,使用 [x] 即可。演示如下:

    - [x] 完成更改
    - [ ] 推送提交到 GitHub
    - [ ] (Optional) 打开拉取请求
    

    :如果任务列表项描述以括号开头,则需要加空格分隔或使用\对其进行转义。

使用表情符号

  • 通过键入 :EMOJICODE: 可在您的写作中添加表情符号。

    @octocat :+1: 这个 PR 看起来很棒 - 可以合并了! :ship:
    

    @octocat 👍 这个 PR 看起来很棒 - 可以合并了! 🚢

  • 键入 : 将显示建议的表情符号列表,该列表将在键入时进行过滤,因此一旦找到所需的表情符号,可按Tab或Enter键以完成突出显示的结果。

段落

  • 通过在文本行之间留一个空白行,可创建新段落。

公式

  • 使用Latex语法将公式写在 $$ $$ 内部,将会自动生成相应的公式。e.g.

    $$
    \mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix}
    \mathbf{i} & \mathbf{j} & \mathbf{k} \\
    \frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
    \frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
    \end{vmatrix}
    $$
    

\[\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} \]

忽略Markdown格式

  • 通过在Markdown字符前使用 \ 来忽略(或转义)Markdown格式。e.g.

    让我们将 \*our-new-project\* 重命名为 \*our-old-project\*。
    

    将 *our-new-project* 重命名为 *our-old-project* 。

Next...


  1. 我也不懂。。。 ↩︎

  2. 怕了怕了!!! ↩︎

posted @ 2021-03-13 00:43  awysl  阅读(56)  评论(0)    收藏  举报