From 7725f7e6ca10080d30c4e86d963080f713d74b0b Mon Sep 17 00:00:00 2001
From: Pablo Guerrero
Date: Fri, 9 Sep 2016 22:08:17 +0200
Subject: Update features.md
---
public/docs/features.md | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
(limited to 'public/docs')
diff --git a/public/docs/features.md b/public/docs/features.md
index 8e884560..ed5d8397 100644
--- a/public/docs/features.md
+++ b/public/docs/features.md
@@ -3,13 +3,13 @@ Features
Introduction
===
- **HackMD** is a realtime collaborate markdown note in all platforms.
-This mean you can do some notes with any other in **Desktop, Tablet or even Phone**.
-You can Sign in via **Facebook, Twitter, GitHub, Dropbox** in the **[homepage](/)**.
+ **HackMD** is a realtime, multiplatform collaborative markdown note editor.
+This means that you can write notes with other people on your **desktop, tablet or even on the phone**.
+You can sign-in via **Facebook**, **Twitter**, **GitHub**, or **Dropbox** in the **[homepage](/)**.
-This service still in early stage, might be buggy or crash.
-Please report issue in [GitHub](https://github.com/hackmdio/hackmd).
-If you need instant help, please use [Facebook Message](https://www.facebook.com/messages/866415986748945).
+Note that this service is still in an early stage, and thus still has some [issues](https://github.com/hackmdio/hackmd/issues?q=is%3Aopen+is%3Aissue+label%3Abug) and might crash.
+Please report issues in [GitHub](https://github.com/hackmdio/hackmd/issues/new).
+If you need instant help, please send us a [Facebook message](https://www.facebook.com/messages/866415986748945).
**Thank you very much!**
Workspace
@@ -514,4 +514,4 @@ Term 2
This is HTML abbreviation example.
It converts "HTML", but keep intact partial entries like "xxxHTMLyyy" and so on.
-*[HTML]: Hyper Text Markup Language
\ No newline at end of file
+*[HTML]: Hyper Text Markup Language
--
cgit v1.2.3
From c639ed94878b23ae7d2fa159931e0e4b4d2849ed Mon Sep 17 00:00:00 2001
From: Pablo Guerrero
Date: Fri, 9 Sep 2016 22:42:12 +0200
Subject: Update features.md
---
public/docs/features.md | 51 ++++++++++++++++++++++++-------------------------
1 file changed, 25 insertions(+), 26 deletions(-)
(limited to 'public/docs')
diff --git a/public/docs/features.md b/public/docs/features.md
index ed5d8397..e79bd7e2 100644
--- a/public/docs/features.md
+++ b/public/docs/features.md
@@ -4,11 +4,11 @@ Features
Introduction
===
**HackMD** is a realtime, multiplatform collaborative markdown note editor.
-This means that you can write notes with other people on your **desktop, tablet or even on the phone**.
-You can sign-in via **Facebook**, **Twitter**, **GitHub**, or **Dropbox** in the **[homepage](/)**.
+This means that you can write notes with other people on your **desktop**, **tablet** or even on the **phone**.
+You can sign-in via **Facebook**, **Twitter**, **GitHub**, or **Dropbox** in the [_homepage_](/).
-Note that this service is still in an early stage, and thus still has some [issues](https://github.com/hackmdio/hackmd/issues?q=is%3Aopen+is%3Aissue+label%3Abug) and might crash.
-Please report issues in [GitHub](https://github.com/hackmdio/hackmd/issues/new).
+Note that this service is still in an early stage, and thus still has some [_issues_](https://github.com/hackmdio/hackmd/issues?q=is%3Aopen+is%3Aissue+label%3Abug).
+Please report new issues in [GitHub](https://github.com/hackmdio/hackmd/issues/new).
If you need instant help, please send us a [Facebook message](https://www.facebook.com/messages/866415986748945).
**Thank you very much!**
@@ -26,50 +26,49 @@ Workspace
View: See only the result.
Edit: See only the editor.
-## Upload image
+## Upload Images:
You can simply press the camera button .
-Or **drag-n-drop** image in editor, even **paste** image works!
-It will automatically upload to **[imgur](http://imgur.com)**, nothing to worry :tada:
+Or **drag-n-drop** image in editor, even **pasting** images is possible!
+This will automatically upload the image to **[imgur](http://imgur.com)**, nothing to worry :tada:
![](https://i.imgur.com/9cgQVqD.png)
-## Share note
+## Share Notes:
If you want to share a **editable** note, just copy the url.
If you want to share a **read-only** note, simply press share button and copy the url.
-## Save
-Currently, you can save to **Dropbox** or save as **.md** to local.
+## Save:
+Currently, you can save to **Dropbox** or save an `.md` file locally.
-## Import
-Like save feature, you can also import **.md** from **Dropbox** .
-Or import from your **Clipboard** , and that can parse some **html** which might be useful :smiley:
+## Import:
+Similarly to the _save_ feature, you can also import an `.md` file from **Dropbox** ,
+or import content from your **clipboard** , and that can parse some **html** which might be useful :smiley:
-## Permission
-There is a little button on the top right of the view.
-You can change the permission via theres options.
-It might be one of below:
+## Permissions:
+It is possible to change the access permission to anote through a little button on the top right of the view.
+There are three possible options:
- Freely: Anyone can edit this note.
- Editable: Signed user can edit this note.
- Locked: Only owner can edit this note.
- Private: Only owner can view and edit this note.
+ **Freely**: Anyone can edit this note.
+ **Editable**: Signed user can edit this note.
+ **Locked**: Only owner can edit this note.
+ **Private**: Only owner can view and edit this note.
-**Only the owner of the note can change the permission**
+**Only the owner of the note can change the permission.**
-## Embed
+## Embed:
```xml
```
-## [Slide Mode](./slide-example)
+## [Slide Mode](./slide-example):
You can use some syntax to divide your note into slides.
Then use **Slide Mode** to made a presentation.
Visit above link for detail.
View
===
-## Table of content
+## Table of Contents:
You can look at bottom right place of the view area, there is a TOC button .
-Press that will show current table of content and will emphasis which your section on.
+Pressing that will show you a current Table of Contents, and will highlight which your section is.
Support up to **three header levels**.
## Permalink
--
cgit v1.2.3
From 963bb7049f03d7d83efc5ee4d9013cc5c5402b1f Mon Sep 17 00:00:00 2001
From: Pablo Guerrero
Date: Fri, 9 Sep 2016 23:44:20 +0200
Subject: Update features.md
---
public/docs/features.md | 64 ++++++++++++++++++++++++-------------------------
1 file changed, 32 insertions(+), 32 deletions(-)
(limited to 'public/docs')
diff --git a/public/docs/features.md b/public/docs/features.md
index e79bd7e2..c6409029 100644
--- a/public/docs/features.md
+++ b/public/docs/features.md
@@ -28,8 +28,8 @@ Workspace
## Upload Images:
You can simply press the camera button .
-Or **drag-n-drop** image in editor, even **pasting** images is possible!
-This will automatically upload the image to **[imgur](http://imgur.com)**, nothing to worry :tada:
+Or **drag-n-drop** an image into the editor, even **pasting** images is possible!
+This will automatically upload the image to **[imgur](http://imgur.com)**, nothing to worry. :tada:
![](https://i.imgur.com/9cgQVqD.png)
## Share Notes:
@@ -48,11 +48,11 @@ It is possible to change the access permission to anote through a little button
There are three possible options:
**Freely**: Anyone can edit this note.
- **Editable**: Signed user can edit this note.
- **Locked**: Only owner can edit this note.
- **Private**: Only owner can view and edit this note.
+ **Editable**: A signed-in user can edit this note.
+ **Locked**: Only the owner can edit this note.
+ **Private**: Only the owner can view and edit this note.
-**Only the owner of the note can change the permission.**
+**Only the owner of the note can change the note's permissions.**
## Embed:
```xml
@@ -60,69 +60,69 @@ There are three possible options:
```
## [Slide Mode](./slide-example):
-You can use some syntax to divide your note into slides.
-Then use **Slide Mode** to made a presentation.
-Visit above link for detail.
+You can use a special syntax to organize your note into slides.
+After that, you can use the **Slide Mode** to make a presentation.
+Visit the above link for details.
View
===
## Table of Contents:
-You can look at bottom right place of the view area, there is a TOC button .
-Pressing that will show you a current Table of Contents, and will highlight which your section is.
-Support up to **three header levels**.
+You can look at bottom right place of the view area, there is a _ToC_ button .
+Pressing that button will show you a current _Table of Contents_, and will highlight which section you're at.
+ToCs support up to **three header levels**.
## Permalink
Every header will automatically add a permalink on the right side.
You can hover and click to anchor on it.
-Edit
+Edit:
===
-## Shortcut keys
-Just like sublime text, which is pretty quick and convinent.
-> For more infomations, see [here](https://codemirror.net/demo/sublime.html).
+## Shortcut Keys:
+Just like Sublime text, which is pretty quick and convenient.
+> For more infomation, see [here](https://codemirror.net/demo/sublime.html).
-## Auto complete
-This editor provide full auto complete hint of markdown.
-- Emojis: type `:` to show hint.
+## Auto-Complete:
+This editor provides full auto complete hints in markdown.
+- Emojis: type `:` to show hints.
- Code blocks: type ` ``` ` and plus a character to show hint. ```
- Headers: type `#` to show hint.
- Referrals: type `[]` to show hint.
- Externals: type `{}` to show hint.
- Images: type `!` to show hint.
-## Title
+## Title:
This will take the first **level 1 header** as the note title.
-## Tags
+## Tags:
Using tags like below, these will show in your **history**.
###### tags: `features` `cool` `updated`
## [YAML metadata](./yaml-metadata)
-Provide advanced note information to set the browse behavior, visit above link for detail
+Provide advanced note information to set the browser behavior, visit above link for detail:
- robots: set web robots meta
-- lang: set browse language
+- lang: set browser language
- dir: set text direction
- breaks: set to use line breaks or not
- GA: set to use Google Analytics
- disqus: set to use Disqus
-- slideOptions: set to setup slide mode options
+- slideOptions: setup slide mode options
-## TOC
+## ToC:
Use the syntax `[TOC]` to embed table of content into your note.
[TOC]
## Emoji
You can type any emoji like this :smile: :smiley: :cry: :wink:
-> See full emoji list [here](http://www.emoji-cheat-sheet.com/)
+> See full emoji list [here](http://www.emoji-cheat-sheet.com/).
-## Todo List
-- [ ] Todos
+## ToDo List:
+- [ ] ToDos
- [x] Buy some salad
- [ ] Brush teeth
- [x] Drink some water
-## Code block
+## Code Block:
We support many code languages, use the auto complete to see the list.
```javascript=
var s = "JavaScript syntax highlighting";
@@ -141,7 +141,7 @@ function $initHighlight(block, cls) {
}
}
```
-> If you want **line numbers**, type `=` after specify the code block languagues.
+> If you want **line numbers**, type `=` after specifying the code block languagues.
> Also, you can specify the start line number.
> Like below, the line number starts from 101:
```javascript=101
@@ -162,14 +162,14 @@ function $initHighlight(block, cls) {
}
```
-> Or you might want to continue the previous code block line number, use `=+`
+> Or you might want to continue the previous code block's line number, use `=+`
```javascript=+
var s = "JavaScript syntax highlighting";
alert(s);
```
-### Blockquotes tags
+### Blockquote Tags:
> Using like below to specifiy your **name, time and color** to differ the blockquotes.
> [name=ChengHan Wu] [time=Sun, Jun 28, 2015 9:59 PM] [color=#907bf7]
> > Even support the nest blockquotes!
--
cgit v1.2.3
From 20fecf28f65075f6503bd946e0cf5faec7b1be42 Mon Sep 17 00:00:00 2001
From: Pablo Guerrero
Date: Sun, 11 Sep 2016 23:19:05 +0200
Subject: Update features.md
---
public/docs/features.md | 78 +++++++++++++++++++++++++------------------------
1 file changed, 40 insertions(+), 38 deletions(-)
(limited to 'public/docs')
diff --git a/public/docs/features.md b/public/docs/features.md
index c6409029..33dcdb86 100644
--- a/public/docs/features.md
+++ b/public/docs/features.md
@@ -26,26 +26,26 @@ Workspace
View: See only the result.
Edit: See only the editor.
-## Upload Images:
-You can simply press the camera button .
-Or **drag-n-drop** an image into the editor, even **pasting** images is possible!
+## Image Upload:
+You can upload an image simply by clicking on the camera button .
+Alternatively, you can **drag-n-drop** an image into the editor. Even **pasting** images is possible!
This will automatically upload the image to **[imgur](http://imgur.com)**, nothing to worry. :tada:
![](https://i.imgur.com/9cgQVqD.png)
## Share Notes:
-If you want to share a **editable** note, just copy the url.
-If you want to share a **read-only** note, simply press share button and copy the url.
+If you want to share an **editable** note, just copy the URL.
+If you want to share a **read-only** note, simply press share button and copy the URL.
-## Save:
+## Save a Note:
Currently, you can save to **Dropbox** or save an `.md` file locally.
-## Import:
+## Import Notes:
Similarly to the _save_ feature, you can also import an `.md` file from **Dropbox** ,
or import content from your **clipboard** , and that can parse some **html** which might be useful :smiley:
## Permissions:
-It is possible to change the access permission to anote through a little button on the top right of the view.
-There are three possible options:
+It is possible to change the access permission to a note through the little button on the top right of the view.
+There are four possible options:
**Freely**: Anyone can edit this note.
**Editable**: A signed-in user can edit this note.
@@ -54,7 +54,9 @@ There are three possible options:
**Only the owner of the note can change the note's permissions.**
-## Embed:
+## Embed a Note:
+Notes can be embedded as follows:
+
```xml
```
@@ -67,7 +69,7 @@ Visit the above link for details.
View
===
## Table of Contents:
-You can look at bottom right place of the view area, there is a _ToC_ button .
+You can look at the bottom right section of the view area, there is a _ToC_ button .
Pressing that button will show you a current _Table of Contents_, and will highlight which section you're at.
ToCs support up to **three header levels**.
@@ -82,7 +84,7 @@ Just like Sublime text, which is pretty quick and convenient.
> For more infomation, see [here](https://codemirror.net/demo/sublime.html).
## Auto-Complete:
-This editor provides full auto complete hints in markdown.
+This editor provides full auto-complete hints in markdown.
- Emojis: type `:` to show hints.
- Code blocks: type ` ``` ` and plus a character to show hint. ```
- Headers: type `#` to show hint.
@@ -94,15 +96,15 @@ This editor provides full auto complete hints in markdown.
This will take the first **level 1 header** as the note title.
## Tags:
-Using tags like below, these will show in your **history**.
+Using tags as follows, the specified tags will show in your **history**.
###### tags: `features` `cool` `updated`
-## [YAML metadata](./yaml-metadata)
-Provide advanced note information to set the browser behavior, visit above link for detail:
+## [YAML Metadata](./yaml-metadata)
+You can provide advanced note information to set the browser behavior (visit above link for details):
- robots: set web robots meta
- lang: set browser language
- dir: set text direction
-- breaks: set to use line breaks or not
+- breaks: set to use line breaks
- GA: set to use Google Analytics
- disqus: set to use Disqus
- slideOptions: setup slide mode options
@@ -118,12 +120,12 @@ You can type any emoji like this :smile: :smiley: :cry: :wink:
## ToDo List:
- [ ] ToDos
- - [x] Buy some salad
- - [ ] Brush teeth
- - [x] Drink some water
+ - [x] Buy some salad
+ - [ ] Brush teeth
+ - [x] Drink some water
## Code Block:
-We support many code languages, use the auto complete to see the list.
+We support many programming languages, use the auto complete function to see the entire list.
```javascript=
var s = "JavaScript syntax highlighting";
alert(s);
@@ -170,14 +172,14 @@ alert(s);
```
### Blockquote Tags:
-> Using like below to specifiy your **name, time and color** to differ the blockquotes.
+> Using the syntax below to specifiy your **name, time and color** to vary the blockquotes.
> [name=ChengHan Wu] [time=Sun, Jun 28, 2015 9:59 PM] [color=#907bf7]
> > Even support the nest blockquotes!
> > [name=ChengHan Wu] [time=Sun, Jun 28, 2015 10:00 PM] [color=red]
## Externals
-### Youtube
+### YouTube
{%youtube 1G4isv_Fylg %}
### Vimeo
@@ -193,7 +195,7 @@ alert(s);
{%speakerdeck sugarenia/xxlcss-how-to-scale-css-and-keep-your-sanity %}
### PDF
-**Caution: this might be blocked by your browser if not using https url.**
+**Caution: this might be blocked by your browser if not using an `https` URL.**
{%pdf https://papers.nips.cc/paper/5346-sequence-to-sequence-learning-with-neural-networks.pdf %}
## MathJax
@@ -212,9 +214,9 @@ $$
> More information about **LaTeX** mathematical expressions [here](http://meta.math.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference).
-## UML diagrams
+## UML Diagrams
-### Sequence diagrams
+### Sequence Diagrams
You can render sequence diagrams like this:
@@ -226,9 +228,9 @@ Note left of Alice: Alice responds
Alice->Bob: Where have you been?
```
-### Flow charts
+### Flow Charts
-And flow charts like this:
+Flow charts can be specified like this:
```flow
st=>start: Start
e=>end: End
@@ -270,12 +272,12 @@ gantt
anther task : 24d
```
-> More information about **Sequence diagrams** syntax [here](http://bramp.github.io/js-sequence-diagrams/).
-> More information about **Flow charts** syntax [here](http://adrai.github.io/flowchart.js/).
-> More information about **Graphviz** syntax [here](http://www.tonyballantyne.com/graphs.html)
-> More information about **Mermaid** syntax [here](http://knsv.github.io/mermaid)
+> More information about **sequence diagrams** syntax [here](http://bramp.github.io/js-sequence-diagrams/).
+> More information about **flow charts** syntax [here](http://adrai.github.io/flowchart.js/).
+> More information about **graphviz** syntax [here](http://www.tonyballantyne.com/graphs.html)
+> More information about **mermaid** syntax [here](http://knsv.github.io/mermaid)
-Alert area
+Alert Area
---
:::success
Yes :tada:
@@ -290,7 +292,7 @@ Watch out :zap:
:::
:::danger
-Oh No :fire:
+Oh No! :fire:
:::
## Typography
@@ -306,7 +308,7 @@ Oh No :fire:
###### h6 Heading
```
-### Horizontal rules
+### Horizontal Rules
___
@@ -315,7 +317,7 @@ ___
***
-### Typographic replacements
+### Typographic Replacements
Enable typographer option to see result.
@@ -484,7 +486,7 @@ Duplicated footnote reference[^second].
and multiple paragraphs.
[^second]: Footnote text.
-### Definition lists
+### Definition Lists
Term 1
@@ -510,7 +512,7 @@ Term 2
### Abbreviations
-This is HTML abbreviation example.
-It converts "HTML", but keep intact partial entries like "xxxHTMLyyy" and so on.
+This is an HTML abbreviation example.
+It converts "HTML", but keeps intact partial entries like "xxxHTMLyyy" and so on.
*[HTML]: Hyper Text Markup Language
--
cgit v1.2.3