Markdown for Worktile 【科普篇】

op小泽马
op小泽马 2014-09-25 11:43 114 29119

Markdown使用指南配图 (1).jpg

引言:Markdown 是一种轻量级的标记语言,轻到你甚至可以不叫他语言,因为 Markdown 很容易上手,就是简单地记住几个常用的标签用法就OK了,Markdown 有诸多好处:专注于文字,简单,高效。这也就是 Worktile 在编辑文档,评论时支持使用 Markdown 的原因吧。我们将分为三个篇章来讲述一些 Markdown 的使用技巧,分别为【科普篇】【进阶篇】【高级篇】,玩转 Markdown 就从这里开始吧!

 下面来详细说说那几个标签(真的只有几个):

QQ20140925-9.png

凡事得有个顺序,上图就是Worktile的Markdown编辑器的Bar排序:从左往右开始

常用标题

QQ20140925-7.png

# 代表h1(一级标题)
## 代表h2(二级标题)
###代表h3(三级标题)
当然了,依次类推,一直到h6都是这样的

效果是这样的:

代表h1(一级标题)

代表h2(二级标题)

###代表h3(三级标题)


链接(有两种写法):

第一种[text](url)

[text](url)
比如说:[Worktile](https://worktile.com)

第二种[text][id] [id]:url

[text][id]

[id]:url
比如说:
[Worktile][1]

[1]: https://worktile.com

text代表你要链接的文字,URL就是连接地址,第二种的id你可以随便定,但建议是用数字就OK,而且在段落中也推荐使用第二种方法并且把[id]:url放在段落之后;因为链接很多时候都很长,会影响编写文档的美感。而且这样反而会更高效.以上效果是这样的:

Worktile

Worktile


插入图片![](image-url)

跟链接的第一种方式很像

![](image-url)
比如
![](https://ww4.sinaimg.cn/mw690/a8bd3be0gw1ekmy7q47oqj20dl01aglf.jpg)

效果是这样的:

QQ20140925-9.png


加粗****

**这是要加粗的文字**   四个星号中间就是你要加粗的内容

我觉得这一个就够了,效果:

这是要加粗的文字 四个星号中间就是你要加粗的内容


斜体**

*这是你要斜体的文字*   两个星号中间就是要斜体的文字

也是这个就够了,效果如下:

这是你要斜体的文字 两个星号中间就是要斜体的文字


代码(开发人员专用)

代码写在`这里是你要写的代码`之间,``号(windows下)就是ESC下面的那个按键,如果是代码块,请放在六个这个符号中间(需换行)

这个搞到我都不知道怎么描述了


无序列表:

* 无序列表内容1
* 无序列表内容2
* 无序列表内容3
一个星号加一个空格,注意星号与文字之间有一个空格

效果:

  • 无序列表内容1

  • 无序列表内容2

  • 无序列表内容3

有序列表:

1. 有序列表内容1
2. 有序列表内容2
3. 有序列表内容3
一个数字加一个点,文子与点之间有一个空格

效果是这样的:

  1. 有序列表内容1
  2. 有序列表内容2
  3. 有序列表内容3

引用>

>这是你要引用的内容
向右的尖括号表示引用

效果:

这是你要引用的内容


水平分割线***

***这是一条水平分割线
用连续的三个星号表示

效果:


一些高大上的使用

空格    

  一个空格
 两个空格,常用于段落缩进

效果如下(请仔细看):

  一个空格
 两个空格,常用于段落缩进


表格:

| Web端         | 移动端         | 客服 |
| ------------- |:-------------:| -----:|
| why520crazy   |发条兔子_zq     | 小泽马 |
| 刘浩           | Cloudya      |   Ray |
| 贺天卓         | 炻玖           |    puppet |

效果(有木有):

Web端 移动端 客服
why520crazy 发条兔子_zq 小泽马
刘浩 Cloudya Ray
贺天卓 炻玖 puppet

还是稍稍麻烦

总结一下:

其实Markdown语法无非就是几个常用的符号: # * () [] >

五个常用的而已,他们的组合也不多,就上面的介绍几个,把他们用熟练,对于个人写作和编辑文档都会有很大的帮助。

偷偷告诉你哦:在Worktile的任务,文档,话题,日程,文件的评论框也是支持Markdown的哦,想要在评论文字中加入链接?没问题,[text](url)帮你搞定。花两分钟来熟悉一下吧!

Worktle 免费了

评 论

Samye Samye
09-25 16:51 #2

终于有指南帖了~

CRPER CRPER
09-25 17:03 #3

支持MARKDOWN了? 实时预览的?

#2楼 @林群贺: 文档编辑就是Markdown语法呀亲

anytao anytao
09-25 20:31 #5

#2楼 @林群贺: 哇哈哈,一直都支持,只是没告诉你。

我了个擦擦 ···程序狗最喜欢这种方式了 -_-

#5楼 @Godaday: 不是一直都是设计师的么?

邦德 邦德
10-06 20:21 #8

太好了

很好很强大

Worktile 应该被更多人知道,不仅仅是IT团队,家人也是一个小团队,都可以来使用。

#9楼 @吴培峰: good point

不错,markdown 是程序员必学的,对其他人来说最好也学学,确实很方便!

#试一试

1.Jack 2.chen

h1 jack

#11楼 @赵文涛: 一般职场人士学起来也还蛮简单的

Ray Ray
10-09 16:10 #16

指南贴写的不错啊..

#15楼 @Ray: @JellyBool 的杰作

#很好很强大

在文档编辑的时候看到#就发现了,然后后来我都是本地写markdown直接粘贴了。不过没想到其他地方也支持

#我

##我们

###我们的 哈哈哈 呵呵呵 无语 来咯 id==12 and value==10

  • a
  • b
  • c

  • a

  • b
  • c

我的引用


我们你们 #他们

#20楼 @SkyWay: 至于吗亲

不支持 删除线 删除的内容

#23楼 @毛子良: 我们为了防止 XSS攻击,所有 HTML Tags 和 Attributes 都是 白名单的。

#一级标题

##二级标题

欢迎使用马克飞象

@(示例笔记本)[马克飞象|帮助|Markdown]

马克飞象是一款专为印象笔记(Evernote)打造的Markdown编辑器,通过精心的设计与技术实现,配合印象笔记强大的存储和同步功能,带来前所未有的书写体验。特点概述:

  • 功能丰富 :支持高亮代码块、插入 LaTex 公式,工作学习好帮手
  • 得心应手 :支持插入图片,无论是本地上传/图片URL/拖放图片/直接截图粘贴,随心所欲
  • 深度整合 :支持选择笔记本和添加标签,支持从印象笔记跳转编辑,轻松管理

号外号外,离线客户端来啦!点击下载


Markdown简介

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— 维基百科

正如您在阅读的这份文档,它使用简单的符号标识不同的标题,将某些文字标记为粗体或者斜体,下面列举了几个高级功能,更多语法请按Ctrl + /查看帮助。

代码块

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

LaTex 公式

$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

表格

Item Value Qty
Computer 1600 USD 5
Phone 12 USD 12
Pipe 1 USD 234

印象笔记相关

笔记本和标签

马克飞象增加了@(笔记本)[标签A|标签B]语法, 以选择笔记本和添加标签。 绑定账号后, 输入(自动会出现笔记本列表,请从中选择。自己纯手工输入无效。

标题

马克飞象会自动使用文档内出现的第一个标题作为笔记标题。例如本文,就是第一行的 欢迎使用马克飞象

快捷编辑

保存在印象笔记中的笔记,右上角会有一个红色的编辑按钮,点击后会回到马克飞象中打开并编辑该笔记。

注意:目前用户在印象笔记中单方面做的任何修改,马克飞象是无法自动感知和更新的。所以请务必回到马克飞象编辑。

数据同步

马克飞象通过将Markdown原文以隐藏内容保存在笔记中的精妙设计,实现了对Markdown的存储和再次编辑。既解决了其他产品只是单向导出HTML的单薄,又规避了服务端存储Markdown带来的隐私安全问题。这样,服务端仅作为对印象笔记 API调用和数据转换之用。

隐私声明:用户所有的笔记数据,均保存在印象笔记中。马克飞象不存储用户的任何笔记数据。

离线存储

马克飞象使用浏览器离线存储将内容实时保存在本地,不必担心网络断掉或浏览器崩溃。为了节省空间和避免冲突,已同步至印象笔记并且不再修改的笔记将删除部分本地缓存,不过依然可以随时通过文档管理打开。

注意:虽然浏览器存储大部分时候都比较可靠,但印象笔记作为专业云存储,更值得信赖。以防万一,请务必经常及时同步到印象笔记

快捷键

帮助 Ctrl + / 同步文档 Ctrl + S 创建文档 Ctrl + Alt + N 最大化编辑器 Ctrl + Enter 文档管理 Ctrl + O 系统菜单 Ctrl + M

整行移动 Alt + 上/下箭头 删除整行 Ctrl + D

加粗 Ctrl + B 插入图片 Ctrl + G 插入链接 Ctrl + L 提升标题 Ctrl + H

关于收费

马克飞象目前已正式发布,为新用户提供 10 天的试用期,试用期过后需要续费才能继续使用。未购买或者未及时续费,将不能同步新的笔记。之前保存过的笔记依然可以编辑。

反馈与建议


感谢阅读这份帮助文档。请点击右上角,绑定印象笔记账号,开启全新的记录与分享体验吧。

我只是来推荐下马克飞象并测试下worktile的,无利益相关

##支持。。多点科普贴

#29楼 @simplee: 恩恩,一定,往期在这里https://worktile.com/club/news/4d28d76deeac4aaca78297346c6b683b

#25楼 @op小泽马: 我看你这也有黑名单呐,del标签就被过滤了。删除线有时候还是很好用的啊

#31楼 @毛子良: 呃,请说的再具体些哈

##广播看来效果不错哇

#33楼 @op小泽马: 直接用github flavored markdown多爽

#36楼 @毛子良: 我们会有新版本的编辑器放出哈

貌似看起來很高級的功能,不過底線加文字的時候,顯示出來底線會變不見了

因為很多檔案夾名稱有包含底線的

\10泰國產品\01_遊戲資料\@遊戲設定 (這連結裡有三個底線)

如果想顯示底線,這個要怎麼克服啊

测试 $$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

这是代码块

# 这是代码注释  
this is code

编辑文档的代码对于普通用户还是过于硬核了,比如编辑表格什么的,某T打头的同类程序在这方面做得不错,如果worktile也能做到就考虑转移过来了……

#41楼 @段忠纲: 编辑器会优化的

能在文档中用表情就好了