How to use the editor at read.cash The editor is pretty simple and tries to get out of your way as much as possible. But, don't let the simplicity fool you - it allows you to do a lot. Headings, subheadings
Adding headings and subheadings is simple - just click **H1** (header), **H2** (subheading) or type a hash (`#`) followed by a space at the beginning of the line, like this:
Bold, italics, links To make something bold, italic or a link to somewhere, just select some text and you'll see a context menu:
Click **B** to make it bold (or you can also press Ctrl+B/Cmd+B), ***I*** for *italics* (Ctrl+I/Cmd+I). "**Add link**" to make a link (it should be Ctrl+K/Cmd+K, but we haven't implemented it yet). **Underline** is Ctrl+U/Cmd+U. You can also use markdown shortcuts, like `**bold**` or `*italic*`. ~~Strike-through~~ is `~strike-through~`. Images To insert an image - just drag-n-drop it to the empty space or click the image button in the toolbar.
Clipboard support The other very convenient way to insert an image is by pasting it from the clipboard. Just copy the image to the clipboard and press `Ctrl+V` or `Cmd+V`on Mac. Embeds We currently support **YouTube**, **Vimeo, Streamable, lbry.tv** **videos and SoundCloud** embedding, but we'll add more integration later. Just paste the URL of the video into the text:
Alternatively you can click the "video" button in the toolbar.
Lists To make a list - start a paragraph with a dash and a space `-` or an asterisk and a space (`*` ) - that should make a list like this: Improve the editor Improve it some more Never stop improving To make a numbered list - start with a number, a dot and space: `1.` , like this: The most important part Second most ...the others
Code There are two kind of code markup: `inline` (for stuff like variable names, etc...) and code block (for long pieces of code). Inline code To make an inline reference, like this: `variableName` - just type a backtick (```), then the name, then another backtick. Or select some text and click `< >` in the popup menu:
Code blocks To make a code block: Code block Just type three backticks (`````), then type or paste your code. Or you can click `<>` on an empty space:
Block quotes "Adding a block quote is pretty easy." - read.cash authors To add a block quote - start a line with `>` .
Saving the article You can always press `Ctrl+S` or `Cmd+S` to save your article or click Save as Draft at the top of the editor.
Publishing the article When you're ready - press the **Publish** button at the top of the editor.
To Do items You can also add "To Do items", like this: Boil the teapot Fry the eggs Take out the garbage Just type `[ ]` at the beginning of the line. You can even **drag** them to move. Images You can also position images on your screen.
You can also add shadow to the image - it makes some content better. Though it mostly works great if you have white background and some padding.
Final notes We understand that our editor is not perfect. There are quirks. There is some missing functionality. But as we're also the ones who are using it - we're definitely going to improve it as much as possible.
71 comments
The ability to import markdown would be great as I write in markdown editors, as do many serious writers. Love the site tho!
Many of the markdown shortcuts are supported by the editor, like `#`, `##`, `###`, `**`, ```, hte only thing you need to do by hand is the linking. We can't allow custom `<html>` in Markdown anyway, as it's a security disaster, considering we host the user wallet. Though I don't understand the use-case. Why would somebody write a read.cash post somewhere in Markdown editor?
I copy-paste raw markdown into the editor here and it is not recognized. Not headings or lists at least. Why would I write a read.cash post in a markdown editor? I write everything in markdown editors. How else would I write? Many of the most popular writing apps for Mac for example are markdown editors, such as Ulysses and IAWriter. BTW the ability to embed tweets might be fun at some point. Thanks for all your hard work on read.cash. It is really impressive what you are doing here.
Yeah, pasting it doesn't work, but there's not much that we can do about it. It's deep inside the open source editor that we use http://tiptap.scrumpy.com/, however typing in Markdown definitely works as you can see in the first (headings) gif. If your editor has a preview feature - you might try copy-pasting the formatted text (the result, with big headings, etc...) - that might work.
Maybe I will try exporting to MS Word format and copying that.
> BTW the ability to embed tweets might be fun at some point. Yeah.. We've tried it a bunch of times, the problem is that mostly everybody except Twitter do it using <iframe> tag, only Twitter has a bunch of markup that doesn't really help. So it's definitely on our minds, but it's definitely not easy :(
Would you consider bestowing the same editing capabilities for writing comments?
It's pretty hard from a technology point of view. We might add **some** capabilities to the comments editor, but definitely not all. The editor is pretty complex and hard to maintain already, we don't want to maintain TWO editors. And there's no easy way to use the same editor in two places.
At least I can see that using the shortcuts for **bold**, _italics_, and `inline code`, still works on comments. And the `>` for quoting as well as the code block works too. Pretty good for the moment being! What's the code to underline? Any shortcuts to insert images? Or at least to link out to imgur?
Basically, all of this should work: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet I don't think there's a way to underline in Markdown Images: `` Though I don't think it's a great idea to insert images into comments :) A link is preferable.
sorry to keep bothering, I received a notice saying that the following article is not approved...again...I have edited it accordingly, can you please check to make sure it can be shown on your site? Thanks. https://read.cash/edit/8a974957
Once the article deemed Non-OC - it's not possible to edit it to become OC, so, create a new article, and just copy all the content to the new article. If you need to quote some sources without triggering Copy-Paste detection - paste the quoted part into the "block quote" inside the article.
oh ok, thanks for the heads up, but i'd like to know if people can still see my article on main page even it deemed as non original article? it's ok to defined it as non original if people can still see my post
No, it's not shown on main page or in sections. Only on your personal page on read.cash
oops, thank you for the reminder, i just made another post for this, thanks.
Hi, this is a great educational article explaining how to use the read.cash editor. My question is whether or not there is functionality to add links to our social media accounts, like Twitter?
Hello. I am new to Read.Cash. I am having difficulty uploading some of my photos and many of them are coming up with this error message 'Request failed with status code 500'. Can anyone explain or help me with issue. Some of my photos have uploaded no problem but many came up with this error message. Cheers. Sam
It's probably because the image is too big. If you still have problems please email hello@read.cash with an example image.
@Read.Cash Hello It is very well simple and easy to use it is better, I would just like a command for a justified margin of the text. Thanks for the work.
What about and "undo" function? Also from phone seems impossible to delete one picture once you pasted.
We highly not recommend writing from a phone. The undo function is as usual - Ctrl/Cmd+Z from a keyboard. To delete a picture - you need to place the cursor after the picture and press backspace. Some of these things we can't fix as they are browser issues, not our editors. Bigger sites (Google Docs, for ex.) have whole teams that have the editor written from scratch to avoid these issues. We can't afford that.
This was very helpful, however, I want to know how to add the "topics" for my article. I do not know if those realistic automatic or need to be added manually but so far, I have seen many people have various topics included in their articles. It would be very helpful if you can clear my confusion. Thank you and God bless.
Topics are deprecated. Use "Add communities"
This is a very big help. I can remember using markdowns when we have to make changes on our knowledgebase system at work. Though I can only remember some. Just a suggestion you can try adding a Preview option too. Thanks read.cash.
The editor is What-You-See-Is-What-You-Get - the editor IS the preview :) Markdown is only used optionally for shortcuts, like press `#` then space to start a heading, but it's not necessary - there are buttons like in Word or any other editor.
Oh that's cool. Indeed. I just discovered these editor help today. I'm positive it will help a lot to make my content more interesting to read. Thanks read.cash!
Thank you very much for clarifying few viewpoints and teaching them here. I guess I can understand the site better now
thank you so much for the guidelines its really helpful. i hope more tips here in site
How do I add an iframe in my post? Does that stuff work or you block it because of XSS etc attacks?
With the exception of YouTube, Vimeo, LBRY, etc... we don't allow any iframes. They shouldn't be able to break out of the iframe and steal the seed, but who knows. If you need an integration with some well-known service that embeds itself via iframes - you can just tell us the service name.
I mean I don’t really need it but I was hoping to get a donatebutton widget going in all my posts. Thought that would look cool.
https://read.cash/@potta/embedenable-donate-bch-button-bceef8ed Do it only if you think it will help the world at large. But maybe stuff from the BCH ecosystem is safe to embed?
If BCH should teach the world something that would be never trust anything :) Of course it wouldn't make sense to trust, because today this site is owned by one guy, in a week he notices that this site gets him nothing, so he sells it or drops it and then suddenly you rely on someone else. Or maybe that guy says something like "hey, I'm not making anything with this, but if I use this code that steals money from read.cash users - I can make $100,000" so he does it, since nobody even knows who he is... and then he can always claim he was hacked and it wasn't his code anyway ;)
Got it. Totally onboard with the whole trustless thing extended to applications and ecosystems as well! Not only should your cash be trustless but also your applications. Makes sense!
Thanksssss
Thank you for the information I got it
Gracias 🤗
My article recently post lost its content. How can I retrieve it? Please help me.
Thanks for this informative article. It answered the questions in my mind.
Of course this article helped me a lot Which things were much awkward for us Now almost a are cleared
would it be possible to add a ref point to an article so if they click on a piece of text it would jump to a specific section?
How can i post my one article to multiple communities. My same article that i have posted on "my article" then i try to post it multiple communities but it does not let me post.
Nice article. This is very helpful to me
thanks, I need this!
NOW I understand thanks to this piece of information I found what I need most
Omg. I am a newbie and this is a really big help. ❤️
Indeed you are a genius, wish to be like you one day. Well explained and you have juct made editing easier
Thank you
Thisis awesome, but im looking for how to get sponsors onto articles
This is valuable information. I was looking for #howto make a table layout. I know this from MarkDown |Header |Row | |---|---| |First | Row | |Second |Row | But it doesn't look to work in article preview. Looking forward to some feature like this. PS. Oh, looks like it somehow works in comments. So lets add it into a code block here for others to explore on it, too. ``` |Header |Row | |---|---| |First |Row | |Second |Row | ``` PPS. Ok, so as you can see in the article I put a link hereafter, the table is not working for articles. https://read.cash/@anli/spiele-slang-glossar-games-abbreviations-glossary-0f4cb98a
More comments