markdown 测试 in Kobito


最近正在学习markdown语法,同时也在接触github.
下面是一些细碎的学习markdown的笔记,自己写的,对我自己很有用的.

好记性不如烂笔头,所以,可以借由笔记,借由qiita的平台,留下一点学习的足迹.

文中有好些自创的名词,句子,格式,...
如果有哪位朋友正在看,请不要对这些自创的玩意感到"困惑"...跳过去就是了,
或者也可以在评论区提问:)

目前markdown有各种标准,头都有点晕了.
本篇的笔记,主要以传统的markdown标准为规范,并参考了很多github的markdown规范.
其他类型的markdown规范,暂不涉及.

这里的第一篇笔记,自己写给自己看的,所以很随性.并且也主要用来测试这个网站和社区的初步使用体验.
很粗疏,挺"杂"的.请海涵.请轻拍.

斜体 *i* 
*Spring* is coming...


加粗 **B**              **推荐...**

I like **spring**.



A 数字标识(正常)        **推荐...**

​1. Spring

2. Summer

3. Fall



a 主实 句点标识           **推荐...**

   (由单星*加单空格置首实现.实际显示效果比数字标识退两格...并且默认首标识开头与上文空一行)

   (星号与单词之间无空格则视为普通表达)       

* spring

* summer

* fall



a1 副空 句点标识 (行首空两格. 必须联合 主实句点 使用)       **推荐...**

     (两个以上主副句点联排时,联排之间必须换行...重要)

 * spring

  * beijing



第二个主副句点联排,上面已经空了一行.

* summer

  * hongkong



实句点 空句点 的表达也可以用 - 实现(与 * 等效)          **推荐...**

- fall

  - boston

---------------------------------------下面语法在 作业部落的 cmd-markdown编辑器中编辑的




* 文本斜体两种方式*A* _A_ 

     -A-(减号不能实现加粗和斜体)...

* 文本加粗两种方式**A** __A__

  * 副级空句点

  - 副级空句点第二种方式

  _ 副级空句点(下划线不能实现空句点)...



* 总之:

粗体 斜体 两种方式: * _(下划线)

主实句点 副空句点 3种方式: * + -(减号) 无序列表

所以: 推荐用*实现 粗体 斜体 

      推荐用 - 实现无序列表的虚实句点,相应地,用 _ 实现粗体(或者用*也行)

主句点默认首行与上文空一行.并且默认下文首行都空两格.



* 若 * + _ - 两边都有空白,则联通空白一起被视作普通字符. 



* 单行减号是分隔符.双行减号产生单行原样.



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

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





* 插入图片链接:  **推荐...**



![Image of 帆船起航](http://cdn-img.easyicon.net/png/11274/1127409.gif)



* 上顿号`的长短背景作用.(首尾各3个上顿号用作代码背景和高亮)

* 给文字添加淡色背景采用两边各一个上顿号,例如: `轻轻显明`



* \#的标题作用以及强制换行作用

* 一级标题采用一个`#`(并且务必紧跟一个空格)...依次类推.

(推荐标识符与右边文字有一个空格..当然不空格也可以.)   **推荐...**

# 时光

## 四季

### 春天

#### 初春

......



秋天(文字下面一行,只要放减号,就对文字产生2级标题效果)  ...推荐...

-

独立行独立等号=也对上文产生1级标题效果

=



__秋天__



# 秋天 (1级大粗效果,最少用)

## 秋天 (2级标题大粗效果,第二常用)

### 秋天 (3级标题加粗和放大效果, 最常用! )

#### 秋天 (4级标题,等同加粗,不过整行都加粗了...)



* 因为markdown默认手动换行只1行有效, 所以想要实际显示更多空行, 需要:

1个#再加1个 空格,可以指定2个空行: (清除上下格式影响,强制分行)



# 

文本开始,按回车N次,只显示1个空行:





# 

这下OK了, #加1个空格, 在实际中产生了2个空行.





* 引用诗人的佳作 `>`. (要脱离>的引用范围必须手动换行...重要)

> 好雨知时节,当春乃发生;

> 随风潜入夜,润物细无声.

> --- 杜甫    (要脱离>的引用范围必须手动换行...重要)



  * 三个`-`号可组成短直线,如上杜甫...





* 文本加粗和斜体

* 清单List--->

* 插入图片--->

* 各级标题, 引用, 加淡色背景, 短直线, 箭头--->

* 插入代码--->

* 其他:



* 上顿号\`的作用:

* 给文字添加淡色背景采用两边各一个上顿号,例如: `轻轻显明`

* 首尾用1个上顿号紧联可能产生的效果:

` int a=3;

int b=5;

int c=6; `



* 插入代码:



  * 融合嵌入不高亮,采用淡色背景: 文字中嵌入 `int a=0`,就是这样子. 



  * 独立嵌入不高亮, 采用先空一行,再第一行行首缩进8格就可

                             (用2个TAB键方便): --->此为法一



                int a=0;

                int b=1;

				

  * 独立嵌入不高亮, 采用首尾各3个上顿号: --->此为法二

 ```

 int a=3;

 int b=5;

 ```

   * 独立嵌入并且高亮,采用上顿号和编程语言说明:

```C

int a=3;

int b=5;

printf("春天来啦!\n");

```



* 自动的*或#,可以采用2次enter键消除.复原.



- [x] 洗衣服已经完成.

- [ ] 还没开始炒菜.



* github特殊处

1. 嵌入emoji:(目前貌似只有github的markdown才可以支持彩色表情)

   sparkles: :camel: :boom:

2. github特殊还有: Hello@yichenruolan - I like you.也可以mention团队名

   (对方会接到来这边看的消息...类似知乎,微博)

3. 托管的代码序号自动生成链接

4. Issue references within a repository(库内问题和消息自动链接格式:)

Any number that refers to an Issue or Pull Request will be automatically converted into a link.

#1

mojombo#1

mojombo/github-flavored-markdown#1



5. Certain references are auto-linked:



* SHA: a5c3785ed8d6a35868bc169f07e40e889087fd2e

* User@SHA: jlord@a5c3785ed8d6a35868bc169f07e40e889087fd2e

* User/Repository@SHA: jlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2e

* #Num: #26

* GH-Num: GH-26

* User#Num: jlord#26

* User/Repository#Num: jlord/sheetsee.js#26



becomes



SHA: a5c3785

User@SHA: jlord@a5c3785

User/Project@SHA: jlord/sheetsee.js@a5c3785

#Num: #26

GH-Num: GH-26

User#Num: jlord#26

User/Project#Num: jlord/sheetsee.js#26



6. Quick quoting



Typing r on your keyboard lets you reply to the current issue or pull request with a comment. Any text you select within the discussion thread before pressing r will be added to your comment automatically and formatted as a blockquote.



7. Issue autocompletion



Typing # will bring up a list of suggested Issues and Pull Requests. Type a number or some text to filter the list, then hit either tab or enter to complete the highlighted result.







* 图片链接:

  ![起航](http://cdn-img.easyicon.net/png/11274/1127409.gif) 

  (最好是一切按照规范格式来.比如上面的右中括号和左小括号之间按照规范是不能有空格的)



* 链接:

  方法一: http://www.zhihu.com/

  方法二: [知乎](http://www.zhihu.com/)



* markdown文件常见结尾有: 文件.md 文件.markdown





* 表格(开始前,必须空一行)

  (作业部落的cmd 小书匠 markble stackedit的表格支持还不错,为知笔记则差)

  (在每行首末都再加上|也可以,不影响.所以也可不加)



朝代|姓名|职位

-|-|-

三国|刘备|蜀国皇帝

唐|魏征|丞相

宋|岳飞|将军



* 表格再加:,放左居左,放右居右,左右都放,则居中.



朝代|姓名|职位

:-|:-:|-:

三国|刘备|蜀国皇帝

唐|魏征|丞相

宋|岳飞|将军





* 删除线 ~~ ~~

  ~~多余句子,可删~~



1. 穿越时光

  1. 在想象中

  2. 在现实里



2. 穿越空间

  * 在想象中

    * 在人的想象中

  * 在现实中

    * 在人类的现实世界里



* \+ -(减号) * 都可以用来表示无序列表

+ 雅典

  + 爱情海

+ 巴黎

+ 新德里

  - 恒河





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

(单行减号线,成为分隔线)



_________________________

(单行下划线,成为分隔线)



---

(1个减号,是实心句点. 2个减号,是原样. 3个减号或3个星号,是分隔线.)     ...推荐...



___

(1个2个下划线,都是原样. 3个下划线,是分隔线)





春天---

(文字紧跟减号,原样)



-----夏天

(减号紧跟文字,原样)



秋天(文字下面一行,只要放减号,就对文字产生2级标题效果)  ...可用...

-

独立行独立等号=也对上文产生1级标题效果

=



以上都是对-的讨论, _ 则除了单独用可用做分隔线外,其他保持原样.  ...重要...

 





# 秋天 (1级大粗效果,最少用)

## 秋天 (2级标题大粗效果,第二常用)

### 秋天 (3级标题加粗和放大效果, 最常用! )

#### 秋天 (4级标题,等同加粗,不过整行都加粗了...)



### 三级标题就是我



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

冬天



* 小动作,如加粗,斜体,标题...什么的,若要生效,一般不用考虑换行

* 唯独 无序列表 代码高亮 表格 ,需要最先换行,才能生效.

* 并且标题\#,无序列表\*,规范写法,需要紧跟一个空格.其他粗体斜体什么的,不需要空格.



- 对LaTeX直白数学公式的支持:

- 爱因斯坦智能守恒公式: (独立行,两个\$符号)  $$E=mc^2.$$



- 我来学数学: E=mc^2. 不错吧?

- 我来学物理: $E=mc^2$. 不错吧? (文中嵌入,一个\$符号)





* 因为markdown默认手动换行只1行有效, 所以想要实际显示更多空行, 需要:

1个#再加1个 空格,可以指定一个空行: (清除上下格式影响,强制分行)



# 

文本开始,按回车N次,只显示1个空行:





# 

这下OK了, #加1个空格, 在实际中产生了1个空行.

# 



* 列表下面的引用>,规范的做法是需要首行首先缩进4空格(1个TAB )

(虽然有的编辑器不缩进,也可以对引用显示缩进效果,比如本cmd编辑器)

* 杜甫写诗:

    > 好雨知时节

    > 当春乃发生



* 可惜作业部落的cmd和stackedit都不支持 完成清单. 只有小书匠和github支持.(列表符号-与链接符号[]的结合)

-[x] 洗衣服已经完成

-[ ] 炒菜还没开始





* 地址链接的两种形式: 完整式 索引式

一下讨论的都是网址链接.图片链接则同理,(只需在第一个[]前面加上感叹号!)



* 完整式链接--->

(可以加标题,可以不加标题):

[知乎网](http//www.zhihu.com/"发现更大的世界")

[知乎网](http//www.zhihu.com/)



* 索引式链接--->

[知乎网][1]

[豆瓣网][2]

* 说明:后面的[]里面可以是 数字 字母 空白(为空白时,就是 隐式链接)

然后比如可以在文件末尾写上链接的详细内容(索引):(其实索引可以写在文中任意的地方)

[1]: http//www.zhihu.com/   "知乎网:发现更大的世界"

[2]: http//www.douban.com/  "豆瓣网:尘世流连"

文末链接索引格式: 

1. [1]之前可以缩进至多3个空格. 

2. 必须有冒号: (重要)

3. 冒号:后面必须跟1个以上的空格或tab. (重要)

4. 网址可以用<>括起来: <http//www.douban.com/>

5. 可以在网址后面写上标题,可以3种形式: (较重要)

1) "豆瓣网:尘世流连"

2) '豆瓣网:尘世流连'

3) (豆瓣网:尘世流连)



* 索引式链接之--->隐式链接(就是后面的[]里空白,等同于前面[]里的文字)

文中某处:

[知乎网][]

[豆瓣网][]

文末索引相应地变成:

[知乎网]: http//www.zhihu.com/   "知乎网:发现更大的世界"

[豆瓣网]: http//www.douban.com/  "豆瓣网:尘世流连"



* 自动链接形式: <http//www.douban.com/>





* 反斜杠



\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线

`   反引号

*   星号

_   底线

{}  花括号

[]  方括号

()  括弧

\#   井字号

\+   加号

\-   减号

.   英文句点

!   惊叹号

全文终:)