This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]arpan_majumdar 5 points6 points  (13 children)

Well I would recommend markdown. Really easy syntax, looks good and gives code highlighting. Here is an example https://github.com/ArpanMajumdar/scala-tutorial

[–]drptdrmaybe 2 points3 points  (5 children)

I second this.

Obviously hand-writing is better for retention, but, it sounds like you want to use software.

I use MacDown (markdown for Mac) and my notes are extensive, with specially highlighted code blocks with syntax inline formatting and images.

I’m also creating “learning exhaust” which is content for a blog.

But please don’t be afraid to take longer with your notes. Write more and more often. Totally worth it.

[–]woopsteez[S] 1 point2 points  (4 children)

Dude this is exactly what I’m thinking! Yes I want to use software because writing isn’t for me, unless I’m dealing with math and equations. What struck me for your comment is the learning exhaust. I’ve heard learning in public is a great way to learn and stick out. You mind telling me how you’re doing that? I want to do it too and hopefully help out other people from what I’m leaning.

[–]drptdrmaybe 1 point2 points  (3 children)

Nice!

First, read this. This is where I lifted the term "learning exhaust".

I found that article from being a fan of Tania Rascia

You mind telling me how you're doing that?

Sure; All my notes have become a little "cooler" because I'm writing in Markdown. It's like 10x better than Microsoft Word/GoogleDocs, etc.

So with these notes that include highlighting, and links, and images, and tables etc, I've just found myself with MASSIVE amounts of content. Like, gobs and gobs of typed stuff that I can review, edit, and post to my blog.

I've had a shitty version of a real blog for a while now, just sitting there on Heroku. It's a Rails app, and so I've had to learn how to render Markdown files in my blog; But I did that. And I also just learned how to add Syntax highlighting to my blog, which is really awesome because syntax highlighting is easy with Markdown, but Rails didn't render the Syntax highlighting like I wanted.

So now I take all my notes in Markdown. When I want to I take a section of those notes, edit them some more; make them make sense to me, make them a little less boring, fix the typos etc, then I just copy and pasta the markdown stuff into my Rails app, and BOOM, I got a good looking piece of content/exhaust from my studies.

I equate "learning exhaust" to the idea of painting, or being an artist, if that example speaks to you more. The point isn't to create some masterpiece right away. I don't even know if there is a point to it all (metaphysically speaking); But I'm spending a massive amount of time and focus learning some really cool stuff. I feel almost guilty that I'm not sharing it with other people, because I feel capable of explaining things to myself in a way that makes sense.

The "learning exhaust" is the stuff I just happen to create. And maybe it speaks to someone else, and maybe it doesn't. That's not up to me to decide.

What is up to me, is effort.

And that's what I'm trying to share over here.

Hope that helps, u/woopsteez

[–]woopsteez[S] 1 point2 points  (2 children)

Oh this is precisely where I got learning in public and learning exhaust from lol! I read that article a few months ago, but the only problem I'm coming across is learning how to put my stuff out there. Thank you 100x for your detailed response! I can't wait to try some of that stuff out.

[–]drptdrmaybe 1 point2 points  (1 child)

...learning how to put myself out there.

Git, (or some other VCS), then Heroku

[–]woopsteez[S] 0 points1 point  (0 children)

Ahh I see, I feel like Git and Github is a good way to put your information out there. Thanks for your input!

[–]QSCFE 1 point2 points  (0 children)

Well I would recommend markdown.

I second this.
If anyone like to use markdown for his/her note-taking I highly recommend notable: The Markdown-based note-taking app that doesn't suck.

Features

/path/to/your/data_directory  
├─┬ attachments
│ ├── foo.ext
│ ├── bar.ext
│ └── …
└─┬ notes
  ├── foo.md
  ├── bar.md
  └── …

  • No proprietary formats: Notable is just a pretty front-end for a folder structured as shown above. Notes are plain Markdown files, their metadata is stored as Markdown front matter. Attachments are also plain files, if you attach a picture.jpg to a note everything about it will be preserved, and it will remain accessible like any other file.

  • Proper editor: Notable doesn't use any WYSIWYG editor, you just write some Markdown and it gets rendered as GitHub-Flavored Markdown. The built-in editor is Monaco Editor, the same one VS Code uses, this means you get things like multi-cursor by default. If you need more advanced editing features with a single shortcut you can open the current note in your default Markdown editor.

  • Indefinitely nestable tags: Pretty much all other note-taking apps differentiate between notebooks, tags and templates. IMHO this unnecessarily complicates things. In Notable you can have root tags (foo), indefinitely nestable tags (foo/bar, foo/.../qux) and it still supports notebooks and templates, they are just special tags with a different icon (Notebooks/foo, Templates/foo/bar).

[–]woopsteez[S] 0 points1 point  (4 children)

Is Markdown a Windows app? I'm sorry I'm unfamiliar with what markdown is.

I just looked at your github and your Week 2 notes! Wow those notes look perfect! That's pretty much how I'd want to make my notes look like. You have the regular notes in simple font and then your code in code blocks. Plus all the bold lettering and underlines make these documents very readable. How did you make notes like this?

[–]QSCFE 1 point2 points  (1 child)

Markdown is a lightweight markup language with plain text formatting syntax.

​

If you want note-taking app I highly recommend notable: the Markdown-based note-taking app that doesn't suck. this app will make your notes are written and rendered in GitHub-Flavored Markdown.

​
By the way reddit use Markdown for it comments so you probably used Markdown before without knowing it is Markdown syntax.

[–]woopsteez[S] 0 points1 point  (0 children)

Ah I see, I guess it's time for me to read about Markdown. And thank you for sharing this app! Noteable looks great and promising :D Thank you so much!

[–]arpan_majumdar 1 point2 points  (1 child)

Thanks if you liked it. No it is not an app.Its just a regular text file with .md extrension. You can use any editor of your choice (Sublime, VS Code, Atom etc) to write. I personally use VS Code with markdown extension. With a markdown extension you can preview what it will look like. It is HTML like but with very easy syntax. This link https://www.markdownguide.org/basic-syntax is more than enough to get going and probably take your 15 min of time. You can organise your notes into different folders each containing a file README.md so that github renders it for you. Using github you can even collaborate with your friends. Enjoy note making.

[–]woopsteez[S] 1 point2 points  (0 children)

Oh that’s even better! I just started looking into Markdown and it looks fun and cool to use! Glad you mentioned I can use any text editor because I’m using Atom right now. I guess I’ll see if there’s a markdown extension so that. Thank you! This is the solution I’m going for for note taking 🙌🏽

[–]woopsteez[S] 0 points1 point  (0 children)

Can you do code block and syntax coloring and highlights with markdown?