PostgreSQL没用过，不了解啊。另外这个程序有中文文档吗？

Currently we support facebook, twitter, github and dropbox signin.
If user have a profile image then show it, and if not, find avatar via profile email, else show the color.

To review note changes and revert.
It's necessary to have change history or blame log.

I hope hackpad's note could be export to gist.
It'll be helpful to discuss & backup
just like sassmeister or codepen.

feature

Let user to annotate some parts of the text or paragraph to comment and discuss.
Like google doc dose.
Need to do more research on this.

For now, it's hard to test anything.
But it should be done.

When two user input in same time, it might cause race condition if the operation request reach the server at a moment.
Or user might undo & redo to other peoples' changes.
To solve these situation, there is a technique called Operational Transformation.
And below are some open source library we can use:

https://github.com/Operational-Transformation/ot.js
https://github.com/share/ShareJS

ot.js seems a better solution, because it also use codemirror as it's editor.
ShareJS will spend more effort, because it use it's own custom db.

Should support a permission of invitee only.
Only the invitee from email or link can edit the note.

It's kinda important and useful to support YAML.
It can generate metadata of the doc.

https://github.com/blog/1647-viewing-yaml-metadata-in-your-documents
http://www.yaml.org/
https://en.wikipedia.org/wiki/YAML

This morning an error occur and cause server down.
It's a 586218 long document and server too long time to parsing it.
Now we need to set a limit and remind user if reach the top.

Should use grunt or gulp to process builds.

For a local install the database schema is required. Is this provided somewhere here?

It's a little bit hard to know other people editing position.
So maybe keep their cursor on the position when they leaving.
Then hide them after period of time.

Sometimes cookie not set and even though cookie will authorize successfully.

Example:

1. Test 1.
   • Blah.
   • Blah.
2. Test 2.

It's formatted correctly on GitHub but not in Hackmd.

There might be some users not using any services we used to do a third-party auth.
So we need a local signin solution, currently we're using passport as the auth middleware.
Then using passport-local to support this will be the best.

First of all, thank you for open source this software!

I only have one issue with it: It uses two full-tiered databases. As far as I can see there is only one table in the PostgreSQL database. That looks like is a huge overhead. Could you please reduce the number of database systems to 1?
I plan to use hackmd for ad-hoc documentation running in a vagrant box. It would be great to reduce the footprint of hackmd in this box. :)

➜ hackmd git:(master) ✗ bash run.sh
error: Forever cannot find process with id: hackmd

DATABASE_URL='change this'
MONGOLAB_URI='change this' \

这两个是什么格式？

As people ask for, to have a popover toolbar(bold, italic...) on the selection text or shortcut keys for markdown will be more friendly to beginners.

The first thing I need to know when I set up an instance of HackMD, ist where the config is located. But it looks like there are many redundancies here.

The DATABASE_URL and MONGOLAB_URI are located in the config.js, processes.son and run.sh.

Why? And why we need those daemon tools at all? All my node projects I've done so far contains a single config.js file which is included everywhere I need to and do not contain daemon tools at all.

They sometimes may have advantages, but this should not be a part of the project. If some user decide to use it, he can set it up himself, but the server should be able to be started with a simple node(js) app.js command.

I'd like to configure apache to serve hackmd at any route like http://example.com/hackmd.

我需要空行的語法

I tried to set up a development instance yesterday, and I can't get it running. The redirect form /new to /:id works, then the page loads and stucks with the loading indicator. I think it could be a socket.io problem, but I haven't debugged it further (no client JS errors are shown).

Are your familiar with this issue or have an advice?

I really like hackmd, I have a dedicated local instance for my personal notes and use it everyday for my projects.

In this context I'd like to be able to choose my URLs instead of having them generated trough uuid.
This would allow a better organisation of notes and easy linking between them.

So basically, entering a non existing url eg: /projects/foobar will automatically create a note at this url.

This coupled to a kind of global userspace option, hackmd could even be used as a wiki or an internal reference web space.

I understand this feature is incompatible with the default usage of hackmd which has a per-user context separated design, this is why I propose to allow this new behavior as an opt-in configuration option.

If you agree with the principle I'll work on that and propose a pull request some day.

Find a place to show the owner.
And record the contributors who ever change the note.

the following is not rendered correctly

Testing:
    something strange with $\LaTeX$. QQ

BTW, this is really an amazing project!! 👍

Some flowcharts are not shown correctly.

For example:

```flow
s=>start: Start
e=>end: End
c=>condition: condition
o=>operation: operation

s->o
o->c
c(yes)->o
c(no)->e
```

Related:
jfromaniello/passport.socketio#110

Maybe can open some APIs to let third-party application to use

We may also show the markdown as slides.
see more as below:
https://github.com/hakimel/reveal.js
https://github.com/webpro/reveal-md

https://github.com/gnab/remark
https://github.com/jdan/cleaver

you can suggestion more

Use npm/bower + webpack and greenkeeper to help to manage the resources.
Reduce the repo size and redundant codes.

Need a group page or a workspace for a small team.
Should use subdomain to provided better experience.

Client side codes now are really a mess.
Should divided scripts into parts according to its usage.
And minify them then include.

As my observation, people want to talk or discuss topic in notes.
And that might cause the note like a mess.
There was an idea to make or integrate some chat system.

But now I think Disqus is another great choice.
To make the experiment better, will also make it SSO.
https://help.disqus.com/customer/portal/articles/236206-integrating-single-sign-on

Currently we support extra tags in blockquote and todo list.
But it should be done in other ways like encode.
like below:

    <!--meta(paragraph_by: ..., line_segment_by: [{foo: , bar: }])   -->

Table always a big issue in markdown.
Not only hard to maintain or collaborate and also ugly.
May think a unique way to solve.
Not a critical issue.

commit a6d1bdd (Updated other packages to lastest versions)
broken the hackmd view and edit function.
I just revert this commit and everything work.

In /public/views/pretty.ejs almost all script paths are combined with the 'url' var to absolute paths

For example:

<link rel="stylesheet" href='<%- url %>/css/site.css'>

This makes some problems behind a proxy.

Is there any reason, why absolute paths are needed here? The only one I could imagine would be to enable the possibility to embed the page on another webpage or in some download.

And where ist this url taken form? It's not the domain or getserverurl(), which is defined in the config.

Github is a huge base of markdown documents.
People might need to fetch from there and commit back, so we will try to support that.

Actually pandoc is pretty good.
It support so many export format and conversions (even export to pdf).
And it can support asciidoc as a cool guy suggested.
http://pandoc.org/

敝人使用的是 Firefox Nightly 44.0a1
這份文件只有我一個人在編輯，可是在大量增刪內容時卻出現片段重複內容

原始碼沒有問題，可是預覽貌似沒有同步齊全

先求短期應變方法，老實說我不知道這算不算是一種bug

Hi,

When writing some markdown using hackmd there's only one thing that bothers me, it's the carriage return ==
behavior which is not supposed to happen.

Original markdown "spec" states:

When you do want to insert a <br /> break tag using Markdown, you end
a line with two or more spaces, then type return.

Yes, this takes a tad more effort to create a <br />, but a simplistic
“every line break is a <br />” rule wouldn’t work for Markdown.
Markdown’s email-style blockquoting and multi-paragraph list items work
best — and look better — when you format them with hard breaks.

I understand that this is a debatable behavior, maybe an option to select the behaviour could work.

1. 支援AsciiDoc，除了使用偏好，許多md的擴充語法在ad已標準化，
2. 所見即所得表格編輯，Hackpad的優點，點選複數表格欄位編輯，
3. 往IPython/Beaker靠攏，除了貼上程式碼，也能執行顯示輸出結果，參考http://beakernotebook.com

AsciiDoc: http://www.methods.co.nz/asciidoc/
AsciiDoctor: http://asciidoctor.org/
Table: http://www.tablesgenerator.com/
Beaker: http://beakernotebook.com

1. Support AsciiDoc, besides preferences, lots of extension in md already standardized in ad.
2. WYSIWYG table editing, it's a pros in Hackpad - editing in multiple cells.
3. Go with IPython/Beaker, not only copy/paste code but also show the output, refer: http://beakernotebook.com

Today $20 (Tomorrow $50) renders as:

Need to allow owner to delete the note

If user don't have the permission but want to involve in.
They can use annotation to suggest, like a comment.
Then can be accepted later by owners.

Privacy and security are really important.
Some users might want to restrict even browsing.
And also prevent search engine index those notes.
Let's do it.

Support export to pdf is important.
Previous research the result is not very satisfied.
But we found gitprint and it's opensource, might try that again.

https://github.com/adamburmister/gitprint.com
https://github.com/alanshaw/markdown-pdf

Can make a chrome extension looks like https://dragdis.com/
Would be great to quick access notes and organize them.

Chrome apps can help to do an offline editing and saving images in local.
Even more convenient to access notes without loading remote resources.