markdown 目录树怎么添加内容目录

Markdown,您只需要掌握这几个 - 综合当前位置:& &&&Markdown,您只需要掌握这几个Markdown,您只需要掌握这几个&&网友分享于:&&浏览:0次Markdown,你只需要掌握这几个题记
  为什么使用Markdown?这是一个问题。答案有很多种。比如,不局限于格式啦,比如.xls文档得用excel打开吧,.doc文档得用word打开吧,.xxx得用xxx打开吧。如果你机子上没有这个软件,岂不是抓瞎了,还能不能愉快的学习了?!因此你需要一种能使用简单的文本编辑器就可以书写,有浏览器就可正常显示的格式或标记,Markdown很适合哦。什么,这个理由不好?那么就权当是装B吧,你说你用Markdown写文档,是不是逼格一下就上去了。(哎,估计也只有我这种新手才用来炫耀,大牛都是不屑的。)
二八定律说:
百分之二十的知识解决百分之八十的问题。
  其实你只需要掌握基本语法标记就可以愉快的玩耍了。经过几个月使用Markdown写文档,发现掌握下面这些标记语法,就可以完成日常文档书写了。什么?要画流程图?这些需求对于大部分时间来说,你是用不到的,你只需要建立一个知识储备就好。遇到了想不起来?打开看一下就是了。想记住?对不起,这种事倍功半的事情,还是少做为妙,毕竟时间是硫酸,管你是什么都能够腐化,只是快慢而已。  那么问题来了,为什么这几个常用的要记住呢?因为这几个是经常使用的,虽然熟能生巧,日久便记住了,但是在熟能生巧的路上总不能天天翻看知识储备吧。太影响效率。何不花一点点时间强行记住,那么在日久记住的道路上,岂不是一路顺风?闲话不多说,来看看你要掌握的语法标记吧。如果你想学习和使用Markdown,我建议:
常用标记要先花一些时间熟记,后面经常使用的话就会形成习惯了,不过脑的正常书写,跟打字一样;
次常用标记要有基本的印象,能记住也是可以的;
不常用标记和专用标记just看看就好,等到使用的时候百度一下,你就知道。
1. 常用标记
1.1.1 说明
使用#表示标题,一级标题使用一个#,二级标题使用两个##,以此类推,共有六级标题。
使用=====表示高阶标题,使用---------表示次阶标题。
1.1.2 示例
# 这是一级标题
## 这是二级标题
### 这是三级标题
###### 这是六级标题
这是高阶标题(效果和一级标题一样 )
这是次阶标题(效果和二级标题一样)
--------------
这是一级标题
这是二级标题
这是三级标题
这是六级标题
这是高阶标题(效果和一级标题一样 )
这是次阶标题(效果和二级标题一样)
1.1.3 注意
#和标题之间最好加一个空格。不要问我为什么,貌似有时候不会被识别为标题?已经忘记自己为什么要加空格了,也许是任性。
====和----表示标题时,大于等于2个都可以表示。
我通常在标题分级时使用标题标记,这个的用处很明了了。
1.2.1 说明
使用[TOC]生成目录。如一开始的目录所示。
1.2.2 示例
1.2.3 注意
如果你的标题都是按照Markdown语法书写的话,可以自动生成层级目录。
我常用 为知笔记 记笔记,可惜为知笔记不支持[TOC]标记,一个悲伤的故事。
[TOC] 标记可能只能放在一级标题的前面,视不同的编译器而定。
1.3.1 说明
使用&表示引用,&&表示引用里面再套一层引用,依次类推。
1.3.2 示例
& 这是一级引用
&&这是二级引用
&&& 这是三级引用
&这是一级引用
这是一级引用
这是二级引用
这是三级引用
这是一级引用
& 这是一级引用
&&这是二级引用
&&& 这是三级引用
&这是一级引用
这是一级引用
这是二级引用
这是三级引用这是一级引用
1.3.3 注意
如果&和&&嵌套使用的话,从&&退到&时,必须之间要加一个空格或者&作为过渡,否则默认为下一行和上一行是同一级别的引用。如示例所示。
引用标记里可以使用其他标记,如:有序列表或无序列表标记,代码标记等。
我通常在引用别人的话或者某些时候做说明时使用引用标记,其实我一直拿不准到底什么情况下使用引用标记才是正确的。如果你知道,我只想说:请务必告诉我。
1.4 代码块
1.4.1 说明
使用```表示代码块。
1.4.2 示例
```javascriptvar canvas = document.getElementById(&canvas&);var context = canvas.getContext(&2d&);```
var canvas = document.getElementById(&canvas&);
var context = canvas.getContext(&2d&);
1.4.3 注意
`这个符号是在Esc键下面,切换到英文下即可。
```后面的javascript表示此段代码为javascript代码,Markdown会自行使用javascript代码颜色渲染。这里也可以不写。PS:谁能够提供一个完整的Markdown可以渲染的语言列表啊,比如:linux命令这里写什么?
本文档所有使用讲解Markdown语法标记示例的地方都是使用代码块标记的。
1.5 行内代码
1.5.1 说明
使用``表示行内代码。
1.5.2 示例
这是`javascript`代码
这是javascript代码
1.5.3 注意
本页部分文字中间的英文字母就是使用行内代码标记标记的。
这个的使用场景我也有些模糊。我常在文字间有英文的时候使用,但有时又不知道该不该使用,困扰。如果你知道,请告诉我。
1.6 导入图片
1.6.1 说明
使用![Alt text](/path/to/img.jpg &Optional title&)导入图片。其中:
Alt text为如果图片无法显示时显示的文字;
/path/to/img.jpg为图片所在路径;
Optional title为显示标题。显示效果为在你将鼠标放到图片上后,会显示一个小框提示,提示的内容就是 Optional title里的内容。
1.6.2 示例
![Markdown](/img//.jpg)
1.6.3 注意
导入的图片路径可以使用绝对路径也可以使用相对路径,建议使用相对路径。
我通常的做法是Markdown文档的同级目录下建立一个pictures文件夹,里面放置所有所需的图片,如果图片多的话,你也可以在pictures文件夹里建立子文件夹归类。
1.7.1 说明
使用1. 2. 3.表示有序列表,使用*或-或+表示无序列表。
1.7.2 示例
例1:有序列表
例2:无序列表
1.7.3 注意
无序列表或有序列表标记和后面的文字之间要有一个空格隔开。
有序列表标记不是按照你写的数字进行显示的,而是根据当前有序列表标记所在位置显示的,如示例1所示。
无序列表的项目符号是按照实心圆、空心圆、实心方格的层级关系递进的,如例2所示。通常情况下,同一层级使用同一种标记表示,便于自己查看和管理。
无序列表和有序列表标记的使用场景也很明了,故不多说。
1.8 粗体和斜体
1.8.1 说明
使用 ** 或者 __ 表示粗体。使用 * 或者 _ 表示斜体。
1.8.2 示例
粗体1 粗体2斜体1 斜体2
1.8.3 注意
前后的 * 或 _ 与要加粗或倾斜的字体之间不能有空格。
我通常在强调时使用加粗标记,在和一行中的加粗区分且也表示强调时使用倾斜标记,这里的倾斜标记的使用场景不明确。如果你知道:请务必告诉我。
1.9.1 说明
具体使用方式请看示例。
------:为右对齐。
:------为左对齐。
:------:为居中对齐。
-------为使用默认居中对齐。
1.9.2 示例
:---------
可以通过此交易查询到所有交易码和菜单的对应关系
编译所有交易
数据库表模型汇总
可以通过此交易查询到所有交易码和菜单的对应关系
编译所有交易
数据库表模型汇总
1.9.3 注意
每个Markdown解析器都不一样,可能左右居中对齐方式的表示方式不一样。
1.10 分割线
1.10.1 说明
使用---或者***或者* * *表示水平分割线。
1.10.2 示例
1.10.3 注意
只要*或者-大于等于三个就可组成一条平行线。
使用---作为水平分割线时,要在它的前后都空一行,防止---被当成标题标记的表示方式。
1.11.1 说明
使用[](link &Optional title&)表示行内链接。其中:
[]内的内容为要添加链接的文字。
link为链接地址。
Optional title为显示标题。显示效果为在你将鼠标放到链接上后,会显示一个小框提示,提示的内容就是 Optional title里的内容。
参考式链接如例所示。
1.11.2 示例
例1:行内链接
这就是我们常用的地址:[Baidu]( &百度一下,你就知道& )
这就是我们常用的地址:
例2:参考式链接
这就是我们常用的地址:[Baidu][1]
[1]: &百度一下,你就知道&
这就是我们常用的地址:
1.11.3 注意
参考式链接和行内链接的显示效果是一样的,但是在编辑状态下的使用情况不一样。行内连接紧跟链接文字,可以在看到链接文字的同时清楚的知道链接地址,但是不便于多次重复利用。参考式链接可以重复使用,但一般都是将一些链接放在一起统一管理,如一段文字后面或文章结尾,因此在找到链接和链接文字的对应关系上有些麻烦。各有利弊了,分情况使用。
使用场景很明了,不多说。
1.11 反斜杠
1.11.1 说明
使用\表示反斜杠。在你不想显示Markdown标记时可以使用反斜杠。
1.11.2 示例
\*这里不会显示斜体\*
*这里不会显示斜体*
1.11.3 注意
1.12.1 说明
Markdown语法会忽略首行开头的空格,如果要体现出首行开头空两个的效果,可以使用全角符号下的空格,windows下使用shift+空格切换。
1.12.2 示例
1.12.3 注意
2. 次常用标记
#### 2.1 标签分类
2.1.1 说明
使用标签:或者Tags:表示标签标记。
2.1.2 示例
标签: 数学 英语
Tags: 数学 英语
标签: 数学 英语Tags: 数学 英语
2.1.3 注意
标签:或者Tags:的冒号要使用半角冒号。
基本没使用过这个标记,不过应用场景应该是归类。便于快速了解文章分类。难道可以通过某种方式来遍历到标签标记?不甚了解。如你知道:请告诉我。
2.2 删除线
2.2.1 说明
使用 ~~表示删除线。
2.2.2 示例
~~这是一条删除线~~
这是一条删除线
2.2.3 注意
注意 ~~ 和 要添加删除线的文字之间不能有空格。
我常使用在显示的告诉自己这行文字是要删除的。
2.3.1 说明
使用 [^footer] 表示注脚。
2.3.2 示例
这是一个注脚测试[^footer1]。
[^footer1]: 这是一个测试,用来阐释注脚。
这是一个注脚测试[^footer1]。
2.3.3 注意
我常在需要解释一个名词,或者一本书,或者一个人时使用脚注标记。
3. 不常用标记
3.1 实现页内跳转
3.1.1 说明
使用html代码实现页内跳转。在要跳转到的位置定义个锚&span id = &jump&&hehe&/span&,然后使用[你好](#jump)将你好设置为一单击即跳转到hehe所在位置的效果。
3.1.2 示例
[你好](#jump)
&span id = &jump&&hehe&/span&
3.1.3 注意
4. 专项使用标记
4.1 流程图
以后在总结吧,现在的我完全没有使用上,没有需求就先不总结了。
4.2 LaTeX公式
以后在总结吧,现在的我完全没有使用上,没有需求就先不总结了。
写在后面的话
[TOC]不支持呀不支持,看不到效果了。
谁有什么好的方式在博客园中更好的显示Markdown,像一样。
更好的Markdown阅读效果:
以上都是我学习到的,然后经过几个月的使用总结的,针对我的常用非常用分类。如果有描述的不对的地方,欢迎批评指正,共同进步。
12345678910
12345678910
12345678910 上一篇:下一篇:文章评论相关解决方案 12345678910 Copyright & &&版权所有为知笔记 Markdown 新手指南
Markdown 是什么
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们「使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档 」—— 维基百科
如果你看不懂以上维基百科对 Markdown 的定义,就当这段掐了没播。约翰·格鲁伯自己对Markdown的描述的重点也在于 「easy-to-read,easy-to-write」。
那么到底 easy 在哪里呢?
虽然称作 「标记语言」,但简单理解 Markdown 就是在文本前增加符号来表示文本格式。你不需要关心标题多大号,列表缩进多少,是否对齐,只要使用了同一种符号标记,Markdown 已经帮你做好了排版。
无图无真相:
Markdown 的好处
编辑,不用操心排版你只需要把注意力放在内容上。笔者在用 Markdown 之前,打开word 先想想,标题用啥字体呢,几号字呢?不知不觉我的意志力就被消耗了。实际上所谓排版,不就是作者的思路以及内容的层级和结构么,在学会使用 Markdown 之后,几个简单的符号就把这些事儿搞定,样式还特别工整精美。
修改,不用担心排版想想那些你在同事之间改来改去的 word 文档吧,如果哪位童鞋从外部粘贴了一段带格式的文字,那么你再次打开文档时会发现整个人都不好了:格式被改的乱七八糟,还要重新调整。如果用 Markdown 群组笔记 ,想改哪里改哪里,根本不用担心格式,改完评论里直接 @TA,多轻松!
一句话来说,Markdown 是用最简单的方式,零排版成本,写出布局工整、阅读舒适的笔记。减少干扰,降低成本,提高效率,不管在什么设备上,看起来都是一个工整的样子。不仅自己阅读爽,分享给朋友也有面儿不是~
那些牛人都在用
阳志平在 2012 年就发博客推崇了一下 Markdown,但那篇文章虽解读深刻,但也略显极客,把Markdown 不仅能排版,能做流程图,还支持数学公式的特性介绍了一遍,连科技论文都要选择 Markdown 都涉猎到了。有兴趣阅读的童鞋可查看。
很多在线博客和内容社区都提供 Markdown 编辑器,不仅在阅读上带来了舒适、统一、美好的体验,每一个参与写作的人,也能够毫不费力地写出排版整齐的文章来。
如何在为知笔记上创建 Markdown 笔记
为知笔记所有客户端都支持 Markdown ,有两种方法可以创建 Markdown 笔记
第一种:在笔记标题后面加 .md ,编辑并保存后,即可看到渲染后的效果
第二种:在移动端直接创建 Markdown 笔记
编辑完成后,点击 「保存」 按钮,即可看到格式精美的笔记啦!
来个小技巧
不管我再怎么说 Markdown 的语法记忆负担小、简单,在最初你都会有点儿晕。在这里给大家分享个小技巧:
最初只需要记住 # 标题一、## 标题二、1. 第一点、* 这一点,用这几个写写日志、需求文档、小文章,排版上足够了;
逐渐的你发现有些文字需要重点指出,那么还可以使用 **加粗**、*斜体* 来对文字做重点说明;
如果你是名程序员,那么可以用 ```
把代码块包起来,渲染后可以关键字高亮,用 & 可以做引用 ;
学生的话,就去了解一下 LaTex 吧,为知笔记 Markdown 支持 Mathjax 公式渲染哦~
Markdown 格式标记符号说明
在行首插入 1 到 6个#,分别表示标题 1 到标题 6
# 这是标题1
## 这是标题1
###### 这是标题6
点击保存后的效果:
2. 有序列表
在行首增加 1.、2.、3.,即数字和英文句点, 注意句点与文字中间有空格。不要求数字一定要连续,可以都是1.
1. 有序列表
1. 有序列表
4. 有序列表
点击保存后的效果:
3. 无序列表
在行首增加 * 或 - 与文字之间有空格
* 无序列表
* 无序列表
点击保存后的效果:
4. 插入图片
可直接粘贴图片,或将图片文件拖动到光标处。
也可以使用标准的Markdown语法,如:
![](/wp-content/uploads/2015/06/wiz_logo.png)
5. 插入链接
[描述](链接地址) ,例如:[为知笔记](),注意要使用英文符号
点击保存后的效果:
6. 粗体、斜体、删除线
粗体:在文字前后添加 ** (注意符号与文字间不要有空格)
斜体:在文字前后添加 *
删除线:在文字前后添加 ~~
~~删除线~~
保存后的效果:
在文字前 添加 &
点击保存后的效果:
如果你无法简洁的表达你的想法,那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦
| 为知笔记|更新 | 版本 |
|------------|-----------|--------|
| WizNote | Markdown| Latest |
点击保存后的效果:
在代码前后增加 三个反单引号:```
int i = 0; i = 1;
for (int i = 0; i & 100; i++)
printf("hello markdown!\n");
保存后的效果:
如果需要指定语言, 在开头的``` 后紧跟具体语言,如: ```java
在任何你想要展示Markdown 笔记目录的地方,添加 [TOC] , 在阅读模式下,标题1~6样式的内容会被提取出来作为目录,相当于大纲功能。
###Markdown 是什么
####Markdown 的好处
点击保存后的效果:
11. Mathjax 公式
可以创建行内公式,例如:$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
或者块级公式,
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
点击保存后的效果:
12. 流程图
st=&start: Start
e=&end: End
op1=&operation: My Operation
sub1=&subroutine: My Subroutine
cond=&condition: Yes or No?
io=&inputoutput: catch something...
st-&op1-&cond
cond(yes)-&io-&e
cond(no)-&sub1(right)-&op1
保存后效果:
1) 关键词(start、end、operation、subroutine、condition和inputoutput)后的冒号后要紧跟一个空格。
2) 使用-&来连接两个元素,对于condition类型,有yes和no两个分支,如示例中的cond(yes)和cond(no)。
更多关于流程图的语法说明:
13. 时序图
```sequence
Alice-&Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob--&Alice: I am good thanks!
保存后效果:
更多关于时序图的语法说明:
在要添加注释的词语后面增加 [^1] ,结尾加入[^1]:空格 注释内容
点击保存后的效果:
欢迎到发帖讨论关于 Markdown 的 ToC,你还想要什么功能? · Ruby China
本帖已被设为精华帖!
大家是否为markdown没办法生成toc(Table of Content)而苦恼?写了个jq插件,可以根据h1到h6自动生成toc,并且可以自动编号
给出效果图如下:
Completely customizable documment selector: 'body' 自定义header文档位置,此处为jq的选择器(已完成)
is_auto_number: false, 默认是否显示header编号(已完成)
is_expand_all: true,默认是否展开全部(已完成)
is_highlight_selected_line是否对选中行,显示高亮效果(TODO)
Click to smooth scroll to that spot on the page(TODO)
Automatically highlight the current section(TODO)
Extremely lightweight (744 bytes gzipped)(TODO)
Can have multiple on a page(TODO)
markdown生成toc 步骤
markdown 转html
html中嵌入插件代码,根据h1到h6自动生成toc
利用锚点定位
toc markdown previewer gem
通过执行tocmd命令,把*.md转成html,并带有toc功能,一个简单的wrapper,希望大家喜欢
目前版本v0.0.8
安装gem install tocmd
指定单个文件
tocmd -f shiti.md
tocmd -d .
目前已经满足我自己的需求了,关于 ToC,大家还想要什么功能?
tocmd v0.0.9
jQuery.zTree_Toc.js v0.2.0
tocmd v0.1.3
.ztree_toc.js
fixed: 另存为的文件里会有编号,所以有编号的就不再重新替换
360浏览器下显示还不正常,todo
已发布到jquery官方插件中,地址:
修复在线演示问题,给出新地址
欢迎关注我的公众号【node全栈】
锚点是算出来的还是可以自己指定的?
是根据header编号算出来的
比如1.1.2 会对应10102,这个地方还需要一步优化,现在step=100,以后应该取header子项最大的树作为step
没有用grunt init:jquery创建项目,有点小忧伤,改了一小会
自己补一个,一个命令可以完成预览
先赞一个。不过,Jekyll 使用 kramdown 可以提供ToC 功能。Stackedit 的ToC功能异常强大。
嗯,谢谢啊,py的md解释器里也有toc的,我先去看看Stackedit和kramdown,哇哈哈
首先支持一个!
"是否对选中行,显示高亮效果" 只是在 TOC 里?
个人感觉 TOC 一般是针对比较长的文档的阅读特别方便, 长文档还几个工具,百度百科做的还不错:
TOC 一直浮动展示, 不至于点到文档末尾切换 toc 就麻烦了.
可以控制自动展开下级菜单, 同时关闭其他打开的菜单---toc长了很有用
增加了toc markdown previewer gem,通过执行tocmd命令,把*.md转成html,并带有toc功能,一个简单的wrapper,希望大家喜欢
1、关于浮动
可以自己用css控制
&ul id="tree" class="ztree"&
2、关于浮动
可以自己用js控制
$(document).ready(function(){
$('#tree').ztree_toc({
ztreeStyle: {
width:'260px',
overflow: 'auto',
position: 'fixed',
'z-index': ,
border: '0px none',
left: '0px',
top: '0px'
3、 可以控制自动展开下级菜单, 同时关闭其他打开的菜单---toc长了很有用
插件有一个参数,默认是否展开全部
由于使用ztree,默认就有展开关闭的功能
滚动更新左侧toc当前项已完成,代码7号放出,家里无网
代码已更新,欢迎反馈
Cool!非常牛
...这...就别放在新手问题里了....
放到开源项目里,您看行么?非常感谢反馈
非常不错,顶一个
gem intall tocmd
install打错了呢
谢谢,已修改
在线演示失效了吧
谢谢啊,已修复在线演示问题,给出新地址 ,欢迎查看
大侠竟然给这个项目star了,哇哈哈
做的时候,发现了一个问题
tocmd在生成文档的时候,本地预览是没有问题,但是在上传gh-pages样式丢失,样式在gem里当然会丢失了,应该再多加一个参数
另外,应该有有选项生成广告语(可选)
本文由开源项目ztree_toc生成,欢迎大家使用反馈
还有大家写markdown的时候要规范
25楼 已删除
请把kgtonglousy禁言,大量广告
其实我觉得是图书这种需求的话 可以试试 asciidoc 已经 git-scribe~
或者 ReStructuredText ~ 不必执着于markdown呀~
demo的教程非常不错
后方可回复, 如果你还没有账号请点击这里 。
共收到 29 条回复Markdown 语法手册 (完整整理版)
我的图书馆
Markdown 语法手册 (完整整理版)
1. 斜体和粗体
2. 分级标题
3.1. 行内式
3.2. 参考式
3.3. 自动链接
5.1. 无序列表
5.2. 有序列表
5.3. 定义型列表
5.3. 列表缩进
5.4. 包含段落的列表
5.5. 包含引用的列表
5.6. 包含代码区块的引用
5.7. 一个特殊情况
6.1. 引用的多层嵌套
6.2. 引用其它要素
7. 插入图像
7.1. 行内式
7.2. 参考式
8. 内容目录
10. LaTeX 公式
10.1. $ 表示行内公式:
10.2 $$ 表示整行公式:
11. 流程图
13. 分隔线
8.1. 行内式
8.2. 缩进式多行代码
8.3. 用六个`包裹多行代码
8.4. HTML 原始码
1. 斜体和粗体
*斜体*或_斜体_**粗体*****加粗斜体***~~删除线~~
显示效果:
这是一段斜体
这是一段粗体
这是一段加粗斜体
这是一段删除线
2. 分级标题
第一种写法:
这是一个一级标题============================这是一个二级标题--------------------------------------------------
第二种写法:
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题
由于用了[TOC]标记编辑器会把所有标题写到目录大纲中,在这里写的演示标题也会列进去,所以就不演示了。同学们自己在编辑器中观察,很简单,一级标题字号最大,依级递减。
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式,行内式一般使用较多。
3.1. 行内式
语法说明:
[]里写链接文字,()里写链接地址, ()中的”“中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。[链接文字](链接地址 “链接标题”)’这样的形式。链接地址与链接标题前有一个空格。
欢迎来到[梵居闹市](/freewalk)欢迎来到[梵居闹市](/freewalk "梵居闹市")
显示效果:
3.2. 参考式
参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。
语法说明:
参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格。
如果链接文字本身可以做为链接标记,你也可以写成[链接文字][]
[链接文字]:链接地址的形式,见代码的最后一行。
我经常去的几个网站[Google][1]、[Leanote][2]以及[自己的博客][3][Leanote 笔记][2]是一个不错的[网站][]。[1]: "Google"[2]: "Leanote"[3]:http:///freewalk "梵居闹市"[网站]:http:///freewalk
显示效果:
我经常去的几个网站、以及
是一个不错的。
3.3. 自动链接
语法说明:
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用&&包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
显示效果:
网页中,锚点其实就是页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如我这里写下一个锚点,点击回到目录,就能跳转到目录。 在目录中点击这一节,就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。
1. Markdown Extra 只支持在标题后插入锚点,其它地方无效。
2. Leanote 编辑器右侧显示效果区域暂时不支持锚点跳转,所以点来点去发现没有跳转不必惊慌,但是你发布成笔记或博文后是支持跳转的。
语法描述:
在你准备跳转到的指定标题后插入锚点{#标记},然后在文档的其它地方写上连接到锚点的链接。
## 0. 目录{#index}跳转到[目录](#index)
显示效果:
跳转到目录
5.1. 无序列表
使用 *,+,- 表示无序列表。
- 无序列表项 一- 无序列表项 二- 无序列表项 三
显示效果:
无序列表项 一
无序列表项 二
无序列表项 三
5.2. 有序列表
有序列表则使用数字接着一个英文句点。
1. 有序列表项 一2. 有序列表项 二3. 有序列表项 三
显示效果:
有序列表项 一
有序列表项 二
有序列表项 三
5.3. 定义型列表
语法说明:
定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格)代码块 2:
这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)
代码块(左侧有八个不可见的空格)
显示效果:
轻量级文本标记语言,可以转换成html,pdf等格式
这是代码块的定义
代码块(左侧有八个不可见的空格)
5.3. 列表缩进
语法说明:
列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
要让列表看起来更漂亮,你可以把内容用固定的缩进整理好(显示效果与代码一致):
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
但是如果你懒,那也行:
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草! *
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。 寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
显示效果:
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
5.4. 包含段落的列表
语法说明:
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致):
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
如果你每行都有缩进,看起来会看好很多,当然,再次地,如果你很懒惰,Markdown 也允许:
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。 寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! *
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
显示效果:
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
5.5. 包含引用的列表
语法说明:
如果要在列表项目内放进引用,那 & 就需要缩进:
阅读的方法:
& 打开书本。
& 打开电灯。
显示效果:
阅读的方法:
打开书本。
打开电灯。
5.6. 包含代码区块的引用
语法说明:
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
一列表项包含一个列表区块:
&代码写在这&
5.7. 一个特殊情况
在特殊情况下,项目列表很可能会不小心产生,像是下面这样的写法:
1986. What a great season.
会显示成:
What a great season.
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠:
1986\. What a great season.
会显示成:
1986. What a great season.
语法说明:
引用需要在被引用的文本前加上&符号。
& 这是一个有两段文字的引用,& 无意义的占行文字1.& 无意义的占行文字2.& & 无意义的占行文字3.& 无意义的占行文字4.
显示效果:
这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.
无意义的占行文字3.
无意义的占行文字4.
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 & :
& 这是一个有两段文字的引用,无意义的占行文字1.无意义的占行文字2.& 无意义的占行文字3.无意义的占行文字4.
显示效果:
这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.
无意义的占行文字3.
无意义的占行文字4.
6.1. 引用的多层嵌套
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 & :
&&& 请问 Markdwon 怎么用? - 小白&& 自己看教程! - 愤青& 教程在哪? - 小白
显示效果:
请问 Markdwon 怎么用? - 小白
自己看教程! - 愤青
教程在哪? - 小白
6.2. 引用其它要素
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
这是第一行列表项。& 2.
这是第二行列表项。& & 给出一些例子代码:& &
return shell_exec("echo $input | $markdown_script");
显示效果:
这是第一行列表项。
这是第二行列表项。
给出一些例子代码:
return shell_exec("echo $input | $markdown_script");
7. 插入图像
图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。
语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。
7.1. 行内式
语法说明:![图片Alt](图片地址 “图片Title”)
美丽花儿: ![美丽花儿](/DownloadImg/2/.jpg "美丽花儿")
显示效果:
美丽花儿:
7.2. 参考式
语法说明:
在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 “Title”
美丽花儿:![美丽花儿][flower][flower]:/DownloadImg/2/.jpg
"美丽花儿"
显示效果:
美丽花儿:
8. 内容目录
在段落中填写 [TOC] 以显示全文内容的目录结构。
效果参见最上方的目录
语法说明:
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。
注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后。
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。[^1]:Markdown是一种纯文本标记语言[^2]:HyperText Markup Language 超文本标记语言[^Le]:开源笔记平台,支持Markdown和笔记直接发为博文
显示效果:
使用 Markdown可以效率的书写文档, 直接转换成 HTML, 你可以使用 Leanote 编辑器进行书写。
注:脚注自动被搬运到最后面,请到文章末尾查看,并且脚注后方的链接可以直接跳转回到加注的地方。
10. LaTeX 公式
10.1. $ 表示行内公式:
质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。
显示效果:
质能守恒方程可以用一个很简洁的方程式 <span data-mathml="E=mc2" role="presentation" style="position:">E=mc2E=mc2 来表达。
10.2 $$ 表示整行公式:
$$\sum_{i=1}^n a_i=0$$$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$
显示效果:
<span data-mathml="&#x2211;i=1nai=0" role="presentation" style="position:">∑i=1nai=0∑i=1nai=0
<span data-mathml="f(x1,xx,&#x2026;,xn)=x12+x22+&#x22EF;+xn2" role="presentation" style="position:">f(x1,xx,…,xn)=x21+x22+?+x2nf(x1,xx,…,xn)=x12+x22+?+xn2
<span data-mathml="&#x2211;k=0j&#x2212;1&#x03B3;&#x005E;kjzk" role="presentation" style="position:">∑k=0j?1γ?kjzk∑k=0j?1γ^kjzk
参考更多使用方法。
11. 流程图
flowst=&start: Start:&io=&inputoutput: verificationop=&operation: Your Operationcond=&condition: Yes or No?sub=&subroutine: Your Subroutinee=&endst-&io-&op-&condcond(yes)-&econd(no)-&sub-&io
显示效果:
Created with Rapha?l 2.1.0StartverificationYour OperationYes or No?EndYour Subroutineyesno
更多语法参考:
语法说明:
不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。
简单方式写表格:
学号|姓名|分数-|-|-小明|男|75小红|女|79小陆|男|92
原生方式写表格:
|学号|姓名|分数||-|-|-||小明|男|75||小红|女|79||小陆|男|92|
为表格第二列指定方向:
产品|价格-|-:Leanote 高级账号|60元/年Leanote 超级账号|120元/年
显示效果:
简单方式写表格:
原生方式写表格:
为表格第二列指定方向:
Leanote 高级账号
Leanote 超级账号
13. 分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *********- - ----------------------------------------
显示效果都一样:
对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。
语法说明:
插入行内代码,即插入一个单词或者一句代码的情况,使用`code`这样的形式插入。
插入多行代码,可以使用缩进或者“` code “`,具体看示例。
注意: 缩进式插入前方必须有空行
8.1. 行内式
C语言里的函数 `scanf()` 怎么使用?
显示效果:
C语言里的函数 scanf() 怎么使用?
8.2. 缩进式多行代码
缩进 4 个空格或是 1 个制表符
一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
#include &stdio.h&
int main(void)
printf("Hello world\n");
显示效果:
#include &stdio.h&int main(void){
printf("Hello world\n");}
8.3. 用六个`包裹多行代码
```#include &stdio.h&int main(void){
printf("Hello world\n");}、、、
显示效果:
#include &stdio.h&int main(void){
printf("Hello world\n");}
8.4. HTML 原始码
在代码区块里面, & 、 & 和 & 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理,例如:
第一个例子:
&div class="footer"&
? 2004 Foo Corporation&/div&
第二个例子:
&th rowspan="2"&值班人员&/th&
&th&星期一&/th&
&th&星期二&/th&
&th&星期三&/th&
&td&李强&/td&
&td&张明&/td&
&td&王平&/td&
&/tr&&/table&
显示效果:
第一个例子:
? 2004 Foo Corporation
第二个例子:
Markdown是一种纯文本标记语言
HyperText Markup Language 超文本标记语言
开源笔记平台,支持Markdown和笔记直接发为博文
TA的最新馆藏}

我要回帖

更多关于 markdown 文件目录树 的文章

更多推荐

版权声明:文章内容来源于网络,版权归原作者所有,如有侵权请点击这里与我们联系,我们将及时删除。

点击添加站长微信