Markdown快速入门教程

2023-11-10

Markdown 的目标是实现「易读易写」,并强调它的「可读性」,因此Markdown 的语法全由标点符号所组成,并经过严谨慎选,是为了让它们看起来就像所要表达的意思;以下是Markdown 大部分的语法。

常用语法- 文字样式

文字字体

类别 语法 显示结果
粗体 **我是粗体** 我是粗体
斜体 *我是斜体* 我是斜体
粗斜体 ***我是粗斜体*** 我是粗斜体
删除线 ~~我是删除线~~ 我是删除线
底线 <u>我是底线<u> 我是底线

文字颜色

Markdown 并没有更改文字颜色的语法,因此只能我们靠自己加入HTML 语法来修改文字颜色,只要在欲更改文字颜色的地方加入<font color=#008000>我是深綠色</font>我是深绿色

在此附上一些常用的颜色,使用者也可以到 常用颜色表 这个网站来找寻自己喜欢的颜色。

语法 显示结果 语法 显示结果
<font color=#800000>酒紅色</font> 酒红色 <font color=#FF0000>紅色</font> 红色
<font color=#FF6600>橘色</font> 橘色 <font color=#FFD700>金色</font> 金色
<font color=#FFFF00>黃色</font> 黄色 <font color=#00FF00>綠色</font> 绿色
<font color=#008000>墨綠色</font> 墨绿色 <font color=#00FFFF>青色</font> 青色
<font color=#0000FF>深藍色</font> 深蓝色 <font color=#FF00FF>粉紅色</font> 粉红色
<font color=#800080>紫色</font> 紫色 <font color=#808080>灰色</font> 灰色

标题

使用 # 来表示等级一的标题,总共有六个等级,且# 字符号和文字间要空一格。语法依此类推:

1 
2 
3 
4 
5 
6
# 等级一标题
## 等级二标题
### 等级三标题
#### 等级四标题
##### 等级五标题
###### 等级六标题

其结果显示如下图:

代码

  • 文字间代码

**插入在文字间**的代码请使用以下语法,也就是用键盘Tab 键上方的反引号来包住:

1
C语言的输入请使用`scanf()` 函式。

其结果显示如下:

C语言的输入请使用 scanf() 函式。

  • 段落代码

若要以整行或整段来显示代码,请使用也就是用键盘Tab 上方的三个反引号来包住,且可以在第一列最后方指定程式语言类型(也能不指定),这样会在特殊函式或语法上标示特殊颜色

例如使用C 语言:

其结果显示如下:

1 
2 
3 
4 
5 
6 
7
// HelloWorld 程式
# include  <stdio.h>

int  main ( )
 { printf ( "HelloWorld\n" ); }
    

笔者查到支援的程式码列表如下,在反引号后输入下面括弧前的文字(参考网站):

  • Cucumber ('*.feature')
    abap ('*.abap')
    ada (' .adb', ' .ads', '*.ada')
    ahk (' .ahk', ' .ahkl')
    apacheconf ('.htaccess', 'apache.conf', 'apache2.conf')
    applescript ('*.applescript')
    as ('*.as')
    as3 ('*.as')
    asy ('*.asy')
    bash (' .sh', ' .ksh', ' .bash', ' .ebuild', '*.eclass')
    bat (' .bat', ' .cmd')
    befunge ('*.befunge')
    blitzmax ('*.bmx')
    boo ('*.boo')
    brainfuck (' .bf', ' .b')
    c (' .c', ' .h')
    cfm (' .cfm', ' .cfml', '*.cfc')
    cheetah (' .tmpl', ' .spt')
    cl (' .cl', ' .lisp', '*.el')
    clojure (' .clj', ' .cljs')
    cmake ('*.cmake', 'CMakeLists.txt')
    coffeescript ('*.coffee')
    console ('*.sh-session')
    control ('control')
    cpp (' .cpp', ' .hpp', ' .c++', ' .h++', ' .cc', ' .hh', ' .cxx', ' .hxx', '*.pde')
    csharp ('*.cs')
    css ('*.css')
    cython (' .pyx', ' .pxd', '*.pxi')
    d (' .d', ' .di')
    delphi ('*.pas')
    diff (' .diff', ' .patch')
    dpatch (' .dpatch', ' .darcspatch')
    duel (' .duel', ' .jbst')
    dylan (' .dylan', ' .dyl')
    erb ('*.erb')
    erl ('*.erl-sh')
    erlang (' .erl', ' .hrl')
    evoque ('*.evoque')
    factor ('*.factor')
    felix (' .flx', ' .flxh')
    fortran (' .f', ' .f90')
    gas (' .s', ' .S')
    genshi ('*.kid')
    glsl (' .vert', ' .frag', '*.geo')
    gnuplot (' .plot', ' .plt')
    go ('*.go')
    groff (' .(1234567)', ' .man')
    haml ('*.haml')
    haskell ('*.hs')
    html (' .html', ' .htm', ' .xhtml', ' .xslt')
    hx ('*.hx')
    hybris (' .hy', ' .hyb')
    ini (' .ini', ' .cfg')
    io ('*.io')
    ioke ('*.ik')
    irc ('*.weechatlog')
    jade ('*.jade')
    java ('*.java')
    js ('*.js')
    jsp ('*.jsp')
    lhs ('*.lhs')
    llvm ('*.ll')
    logtalk ('*.lgt')
    lua (' .lua', ' .wlua')
    make (' .mak', 'Makefile', 'makefile', 'Makefile. ', 'GNUmakefile')
    mako ('*.mao')
    maql ('*.maql')
    mason (' .mhtml', ' .mc', '*.mi', 'autohandler', 'dhandler')
    markdown ('*.md')
    modelica ('*.mo')
    modula2 (' .def', ' .mod')
    moocode ('*.moo')
    mupad ('*.mu')
    mxml ('*.mxml')
    myghty ('*.myt', 'autodelegate')
    nasm (' .asm', ' .ASM')
    newspeak ('*.ns2')
    objdump ('*.objdump')
    objectivec ('*.m')
    objectivej ('*.j')
    ocaml (' .ml', ' .mli', ' .mll', ' .mly')
    ooc ('*.ooc')
    perl (' .pl', ' .pm')
    php (' .php', ' .php(345)')
    postscript (' .ps', ' .eps')
    pot (' .pot', ' .po')
    pov (' .pov', ' .inc')
    prolog (' .prolog', ' .pro', '*.pl')
    properties ('*.properties')
    protobuf ('*.proto')
    py3tb ('*.py3tb')
    pytb ('*.pytb')
    python (' .py', ' .pyw', ' .sc', 'SConstruct', 'SConscript', ' .tac')
    rb (' .rb', ' .rbw', 'Rakefile', ' .rake', ' .gemspec', ' .rbx', ' .duby')
    rconsole ('*.Rout')
    rebol (' .r', ' .r3')
    redcode ('*.cw')
    rhtml ('*.rhtml')
    rst (' .rst', ' .rest')
    sass ('*.sass')
    scala ('*.scala')
    scaml ('*.scaml')
    scheme ('*.scm')
    scss ('*.scss')
    smalltalk ('*.st')
    smarty ('*.tpl')
    sourceslist ('sources.list')
    splus (' .S', ' .R')
    sql ('*.sql')
    sqlite3 ('*.sqlite3-console')
    squidconf ('squid.conf')
    ssp ('*.ssp')
    tcl ('*.tcl')
    tcsh (' .tcsh', ' .csh')
    tex (' .tex', ' .aux', '*.toc')
    text ('*.txt')
    v (' .v', ' .sv')
    vala (' .vala', ' .vapi')
    vbnet (' .vb', ' .bas')
    velocity (' .vm', ' .fhtml')
    vim ('*.vim', '.vimrc')
    xml (' .xml', ' .xsl', ' .rss', ' .xslt', ' .xsd', ' .wsdl')
    xquery (' .xqy', ' .xquery')
    xslt (' .xsl', ' .xslt')
    yaml (' .yaml', ' .yml')

常用语法- 其它

分隔线

一整列中输入三个以上的 *** 或三个以上的---,且整列不能有其它文字,结果显示如下:


项目符号/编号

项目符号可以用*+-,放在整列的开头当作项目符号,且符号和文字间要空一格,语法范例如下:

1 
2 
3
+ aaa 
+ bbb 
+ ccc

其结果显示如下:

  • aaa
  • bbb
  • ccc

而**编号就是使用数字在加上.且 . 和文字间要空一格**,语法范例如下:

1 
2 
3
1. aaa 
2. bbb 
3. ccc

其结果显示如下:

  1. aaa
  2. bbb
  3. ccc

若使用** 「阶层式」的项目符号/编号**,只要记得空的格数要整齐即可。

1 
2 
3 
4 
5 
6 
7 
8 
9 
10
+ 益者三友
  + 友直
  + 友谅
  + 友多闻
     + 益矣
+ 损者三友
  + 友便辟
  + 友善柔
  + 友便佞
     + 损矣

其结果显示如下:

  • 益者三友
    • 友直
    • 友谅
    • 友多闻
      • 益矣
  • 损者三友
    • 友便辟
    • 友善柔
    • 友便佞
      • 损矣

代办事项

代办事项的语法如下,若要在框框中打勾,则需在[ ] 中输入x

1 
2 
3 
4
- [ ] 空心菜
- [x] 玉米
- [x] 酱油
- [ ] 猪肉

其结果显示如下:

  • 空心菜
  • 玉米
  • 酱油
  • 猪肉

引用区块

使用 > 放在整列的开头当作引用区块,且 > 和文字间要空一格,语法范例如下:

1 
2 
3
> 人远比自己想象的要坚强
> 特别是当你回头看看的时候
> 你会发现自己走了一段自己都没想到的路

其结果显示如下:

人远比自己想象的要坚强
特别是当你回头看看的时候
你会发现自己走了一段自己都没想到的路

而”引用”也支援「阶层式」显示:

1 
2 
3
> 人生就像一杯茶
> > 不会苦一辈子
> > > 但总会苦一阵子

其结果显示如下:

人生就像一杯茶

不会苦一辈子

但总会苦一阵子

文字超连结

1 
2 
3
[奇摩首页](https://tw.yahoo.com/) 
[Google首页](https://www.google.com/) 
[Facebook](https://www.facebook.com/)

其结果显示如下:

奇摩首页
Google首页
Facebook

图片

图片的语法和文字超连结很像,只是在语法开头再加上!中括弧内指的是图片的”替代文字” (当图片连结失效后会显示的文字,如下面的FB Logo):

1 
2 
3
![奇摩首页Logo](https://s1.yimg.com/rz/d/yahoo_frontpage_zh-Hant-TW_s_f_p_bestfit_frontpage_2x.png) 
![Google首页Logo](https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png) 
![FB Logo](123.png)

其结果显示如下:

奇摩首页Logo

Google首页Logo

FB Logo

表格

表格的基本语法如下,第一列是表格的标题列,然后第二列固定要是以 --- 做区隔,加栏位都是使用 | 来添加。注意表格的每栏宽度会自动分配,所以可以忽略一切的空格(也就是每列的 | 没有对齐也没关系,且加多少空格也不会影响每栏的宽度)。

1 
2 
3 
4
| Column 1 | Column 2 | Column 3 | 
| -------- | -------- | -------- | 
| Text1 | Text2 | Text3 | 
| Text4 | Text5 | Text6 |

其结果显示如下:

Column 1 Column 2 Column 3
Text1 Text2 Text3
Text4 Text5 Text6

而每栏可以决定要如何对齐,对齐方式取决于第二列的---,再加上 : 符号:

  • :---靠左对齐。
  • ---:靠右对齐。
  • :---:置中对齐。
1 
2 
3 
4 
5
| 预设对齐| 靠左对齐| 靠右对齐| 置中对齐| 
| ----- | :----- | -----: | :-----: | 
| Text1 | Text2 | Text3 | Text4 | 
| Text5 | Text6 | Text7 | Text8 | 
| Text9 | Text10 | Text11 | Text12 |

其结果显示如下:

预设对齐 靠左对齐 靠右对齐 置中对齐
Text1 Text2 Text3 Text4
Text5 Text6 Text7 Text8
Text9 Text10 Text11 Text12

注意事项

  • 某些语法的外观样式如:引用、分隔线、项目符号等,会因为使用者套用的Hexo 主题而有不同。

  • 图片可以放在Hexo 资料夹一并上传到GitHub,例如图片123.jpg 放到myblog/source/images路径下,然后图片语法连结的地方输入/images/123.jpg,就会显示该图片。
    不过这种方法笔者不建议(也就是不建议把GitHub 当作图床用),因为当文章一多,会有机会达到GitHub Pages 的使用限制;因此可以搜寻各大免费图床来使用,如Imgur , Upload.cc

  • ** HTML 语法尽量包在Markdown 语法里面**,否则可能会造成一些显示上的错误,举例如下:

1 
2 
3 
4 
5 
6
语法撰写范例一:将「今天天气真好。」显示粗体并更改为红色
**<font color=#FF0000>今天天气真好。</font>**

语法撰写范例二:将「Title」设定成等级一标题并更改为蓝色
# <font color=#0000FF>Title</font>

  • 呈上,因为HTML 语法和Markdown 语法交错使用,在hexo-admin 文章后台的编辑区和预览区可能会有显示问题,请先publish 后,以localhost 的文章页面显示为准
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

Markdown快速入门教程 的相关文章

随机推荐

  • 电子学会 青少年编程等级考试(C语言)七级 试题

    7级 2022 3 01 红与黑 Flood Fill 红与黑 NOIP CSP c 经典例题选讲41 Flood Fill 红与黑 NOIP CSP c 经典例题选讲41 哔哩哔哩 bilibili AcWing 1113 红与黑 bfs
  • Python安装及环境配置

    编程语言分类 编译型 go语言 c语言 一次性把源代码进行翻译 特点是 执行效率高 平台依赖性一般比较高 解释型 js语言 python语言 ruby语言 逐行地对源代码进行翻译和运行 特点是 执行效率相对较低 平台的依赖性不高 安装各个平
  • 编程常用字体Consolas、Fira Code、Source Code Pro

    编程时方便查看 且中文符号与英文符号区别大 便于排错 1 Consolas 一种等宽字体 属于最常用的编码字体下载地址 参考图 2 Fira Code 一种专为代码排版优化的等宽字体 基于 Fira Mono 等宽字体的一个扩展 主要特点是
  • el-element中el-tabs案例的使用

    el element中el tabs的使用 代码呈现
  • cherry-pick的错误分析

    在cherry pick的时候出现以下错误提示 是对同一提交重复做cherry pick引起的 On branch You are currentlycherry picking all conflicts fixed run gitcom
  • 2023华为OD机试真题【最短木板长度/贪心算法】

    题目描述 小明有 n 块木板 第 i 1 i n 块木板长度为 ai 小明买了一块长度为 m 的木料 这块木料可以切割成任意块 拼接到已有的木板上 用来加长木板 小明想让最短的木板尽量长 请问小明加长木板后 最短木板的长度可以为多少 输入描
  • 自媒体工具网站

    黑镜虚拟科技 MetaMaker V2 2 1 B22 11 01 10 48 18 Giios自动写作机器人 Giiso写作机器人 一款内容创作AI辅助工具 视频背景音乐自动匹配工具 巨量创意 图片微动工具 巨量创意 网络资源所搜工具 百
  • CVE-2023-32315:Openfire管理控制台身份验证绕过到RCE的复现

    CVE 2023 32315 Openfire管理控制台身份验证绕过到RCE复现 前言 本次测试仅供学习使用 如若非法他用 与本文作者无关 需自行负责 一 Openfire简介 Openfire是根据开源Apache许可证授权的实时协作 R
  • es6怎么将对象转换为指定数组格式

    let obj a 1 b 2 c 3 var aa Object values obj 1 2 3 console log aa var arr Object entries obj console log arr 0 2 a 1 1 2
  • 过流检测与保护电路

    在数字压力开关项目中 压力表的输出电路开关负载 输出电路要求负载电流最大为50mA 需要在负载电路中加一个电流检测和保护电路 在负载高电压一端或者低电压一端串入一个高精度小阻值采样电阻 电阻值的选取要注意分担的电压和功率不能太大 同时也要主
  • 超大规模数据库集群保稳系列之三:美团数据库容灾体系建设实践

    本文整理自美团技术沙龙第75期的主题分享 美团数据库攻防演练建设实践 系超大规模数据库集群保稳系列 内含4个议题的PPT及视频 的第3篇文章 本文重点介绍了美团数据库的容灾体系建设实践 主要内容包括业务架构 数据库容灾平台能力建设 演练体系
  • VS打开项目或解决方案卡死,一直处于未响应状态。

    VS打开项目或解决方案卡死 一直处于未响应状态 参考文章 1 VS打开项目或解决方案卡死 一直处于未响应状态 2 https www cnblogs com dh123 p 10474694 html 备忘一下
  • Linux系统(Centos 7)redis

    1 redis背景 1 1 什么是NOSQL nosql not only sql 不仅仅是sql NoSQL 泛指非关系型的数据库 非关系型的数据库则由于其本身的特点得到了非常迅速的发展 非关系数据库和关系型数据库之间的区别 RDBMS
  • LR11_RUN-TIME SETTINGS配置解读

    LR11中RUN TIME SETTINGS重要配置解读 1 配置入口 右键选中任意一个ACtions 2 Run Logic配置说明 PS LR12还多一个脚本执行策略的配置 多个ACTION时是顺序执行 还是随机执行 3 Pacing配
  • 0.IDA-基本操作

    打开IDA 拖拽一个EXE文件进去 首先会弹出如下窗口 Kernel option1 Kernel option2 Processor option这三个选项会控制反汇编引擎的工作状态 一般按默认即可 大多数情况下 分析选项的默认值在准确性
  • AnacondaNavigator安装keras亲身详细步骤

    废话不多说直接上过程 1 在开始菜单搜索anaconda 这很简单直接上图 然后我们的打开conda命令行 就是那个Prompt 2我们先知道一下要下载keras库不光是一个keras 所以 我们的下载顺序是 libpython mingw
  • 剑指 Offer 63. 股票的最大利润(java+python)

    假设把某股票的价格按照时间先后顺序存储在数组中 请问买卖该股票一次可能获得的最大利润是多少 示例 1 输入 7 1 5 3 6 4 输出 5 解释 在第 2 天 股票价格 1 的时候买入 在第 5 天 股票价格 6 的时候卖出 最大利润 6
  • 雪花id生成算法

    什么是雪花算法 雪花算法的本质为生成一个64位长度的具有自增性的分布式全局唯一id 在64bits中 会对不同段的位进行划分 可分为 符号段 时间戳段 机器码段 data center worker 自增序列号段 位段详解 第一位 符号位
  • [cesium]

    源码 正在为您运送作品详情 Web3D 三维特效
  • Markdown快速入门教程

    Markdown 的目标是实现 易读易写 并强调它的 可读性 因此Markdown 的语法全由标点符号所组成 并经过严谨慎选 是为了让它们看起来就像所要表达的意思 以下是Markdown 大部分的语法 常用语法 文字样式 文字字体 类别 语