From 7725f7e6ca10080d30c4e86d963080f713d74b0b Mon Sep 17 00:00:00 2001 From: Pablo Guerrero Date: Fri, 9 Sep 2016 22:08:17 +0200 Subject: [PATCH 1/4] Update features.md --- public/docs/features.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/public/docs/features.md b/public/docs/features.md index 8e88456..ed5d839 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 From c639ed94878b23ae7d2fa159931e0e4b4d2849ed Mon Sep 17 00:00:00 2001 From: Pablo Guerrero Date: Fri, 9 Sep 2016 22:42:12 +0200 Subject: [PATCH 2/4] Update features.md --- public/docs/features.md | 51 ++++++++++++++++++++--------------------- 1 file changed, 25 insertions(+), 26 deletions(-) diff --git a/public/docs/features.md b/public/docs/features.md index ed5d839..e79bd7e 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 From 963bb7049f03d7d83efc5ee4d9013cc5c5402b1f Mon Sep 17 00:00:00 2001 From: Pablo Guerrero Date: Fri, 9 Sep 2016 23:44:20 +0200 Subject: [PATCH 3/4] Update features.md --- public/docs/features.md | 64 ++++++++++++++++++++--------------------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/public/docs/features.md b/public/docs/features.md index e79bd7e..c640902 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! From 20fecf28f65075f6503bd946e0cf5faec7b1be42 Mon Sep 17 00:00:00 2001 From: Pablo Guerrero Date: Sun, 11 Sep 2016 23:19:05 +0200 Subject: [PATCH 4/4] Update features.md --- public/docs/features.md | 78 +++++++++++++++++++++-------------------- 1 file changed, 40 insertions(+), 38 deletions(-) diff --git a/public/docs/features.md b/public/docs/features.md index c640902..33dcdb8 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