• Activity
  • Votes
  • Comments
  • New
  • All activity
  • Showing only topics with the tag "note taking". Back to normal view
    1. What Is A Secure Note-Taking App?

      I've been using Google's Keep Notes for all my note-taking, but I would like to shift away from that and use an app that is more secure. I've heard of Notion and Evernote but I'm not sure about...

      I've been using Google's Keep Notes for all my note-taking, but I would like to shift away from that and use an app that is more secure. I've heard of Notion and Evernote but I'm not sure about their level of security/encryption. Any suggestions?

      20 votes
    2. Learning and studying things without taking notes

      I'm curious if there's anybody here who's like this. Either doing it without writing things down, or doing it minimally. I don't know why but I find it very difficult to do, and it stops me from...

      I'm curious if there's anybody here who's like this. Either doing it without writing things down, or doing it minimally. I don't know why but I find it very difficult to do, and it stops me from actually learning/studying. I feel like it slows me down, significantly. It also feels like a chore. I feel like part of this may be because I'm in information security? Like, there's a lot of reading and researching going on, then immediate practicing and applying. Even when I have to take tests. I just read and listen or whatever else and that's it. Maybe in other fields, taking notes is a big thing, or maybe it's just me. I also have other interests, but yet still, I simply can't bring myself to write things down. I just prefer to absorb everything, in whatever pace I like, sometimes it's slow, sometimes it's fast. If I ever decide that I'm going to take notes while learning/studying, I'd stare at my notebook/software for a very long time. I'd sit with one chapter/slide for quite awhile. At the same time, I truly admire people who take notes and write stuff. I do wish I was like them sometimes. Is anybody out here the same? Even though I really want to hear from people who are similar, everyone else can join the discussion too. What do you do? How do you do it? What is your preference? Do you think there's a "better" way to do things? Could taking notes be "superior" to the opposite?

      27 votes
    3. People with a "second brain": Why? How?

      I've been looking around at different note-taking apps (Notion, Obsidian, Anytype, Joplin, Logseq, etc.) after seeing a few videos about the idea of having a "second brain", and only how has the...

      I've been looking around at different note-taking apps (Notion, Obsidian, Anytype, Joplin, Logseq, etc.) after seeing a few videos about the idea of having a "second brain", and only how has the the thought popped into my mind, "What's the point?". A “second brain” seems like it would require spending too much processing power on something that only exists to exist. What are the chances there you're going to remember any given thing after writing it down? You haven’t filled up your first brain yet. This all sounds very pessimistic - my intention is not to insult anyone's choice to use these tools, but I'm curious of what benefits people have gotten from their "second brains". Maybe I'm just the wrong kind of person for it, or maybe it's just that I'm not used to writing things down.

      Edit: I'm coming to an interesting conclusion that many people use their version of a second brain for things they need to do. This isn't really what I was referring to, I was more looking at it as a form of journaling or personal research, which might be less common?

      33 votes
    4. Looking for a good note-taking app

      Looking for recommendations for a multiplatform note taking app. Needs to support Windows and Android. Some things I'm looking for: Markdown support offline/local support (should be stored in an...

      Looking for recommendations for a multiplatform note taking app. Needs to support Windows and Android. Some things I'm looking for:

      • Markdown support
      • offline/local support (should be stored in an easily accessible and movable format e.g. markdown)
      • is free or only a one time fee
      • Syncing (either a one time fee via app dev or built in support for GDrive or OneDrive)
      • Mind mapping functionality (including linking between notes)
      • flexibility to be both a knowledge base and a place to keep todo lists and general small notes

      Obsidian hits most of these features but without paying $8/mo, syncing is a huge pain in the ass. I got it to sync between machines if I store my vaults in Google Drive, but I'd prefer to have them locally then synced. I don't mind paying for software, but I'm trying to avoid another monthly fee on top of everything else I'm paying for. I'm open to staying with Obsidian if I can solve the syncing issues, too.

      34 votes
    5. Researchers, how do you take notes on the papers which you read?

      I've been struggling with finding a good workflow for taking notes on the journal articles which I read. I collate articles using Zotero, yet its in-built notetaking features (and comment scraping...

      I've been struggling with finding a good workflow for taking notes on the journal articles which I read. I collate articles using Zotero, yet its in-built notetaking features (and comment scraping from PDFs) is quite poor. So, my alternative so far has been to write up notes by hand, but this is pretty cumbersome and makes it take some time to refer to my notes. My approach is clearly not effective!

      How do you take notes on the papers which you read? Do you prefer to use written notes, or do you type your notes? In any case, what is your preferred means of storing and categorising your notes? And are there particular software which you use, if you opt for typed notes? (At present, I use an A5 notebook. Yet, this is not alphabetised or organised by topic, which compounds my struggles.)

      25 votes
    6. How do you make meeting notes?

      I saw some topics on note-taking programs and apps, so I felt a topic on note-taking strategies would be a nice complementary one. When I was still a student, I experimented with various note...

      I saw some topics on note-taking programs and apps, so I felt a topic on note-taking strategies would be a nice complementary one. When I was still a student, I experimented with various note types (mind map, Cornell, bullet points,...) but ever since I started working, I've sort of stopped experimenting. Hence my question: how do you take meeting notes?

      9 votes
    7. What Obsidian plug-ins do you use?

      It seems that Obsidian is a very popular note-taking software within the community here, so I would like to know what plugins you use for your daily workflow in Obsidian. I will start: Advanced...

      It seems that Obsidian is a very popular note-taking software within the community here, so I would like to know what plugins you use for your daily workflow in Obsidian. I will start:

      • Advanced Tables: Very useful for adding and managing markdown tables using simple intuitive keyboard strokes.

      • Callout Manager: I tend to abuse the callout function (in my academic vault, I organize any kind of information inside a callout with the source of the info as the title), so it is good to have control of the colors for different kinds of callouts.

      • Minimal Theme Settings: Nothing much to talk about. Just some eye candy to make my notes easier on the eyes. Plus, the focus mode is very good for study sessions.

      • Obsidian Matrix: Allows me to organize some mathematical LaTeX code properly.

      • Reading Time: Useful to grasp the length of a longer note at a quick glance.

      • Recent Files: Helps me set myself around my files.

      • Style Settings: Complement of "Minimal Theme Settings" to achieve maximum eye candy.

      • List Callouts: I use it only in my personal projects vault. It helps me give particular emphasis to specific topics within my lists.

      • Table of Contents: Useful for longer, heavily-structured notes.

      Aside from that, I also have four CSS snippets:

      1. Align: Aligns my linked figures to the center of the page.
      2. Callout: Specifies the size of callouts (useful, as I mainly structure my notes inside callouts).
      3. Hide: Hides my "resources" folder from the Obsidian explorer (this folder contains files such as figures and PDFs that I link into my notes).
      4. Justify: Justifies all the text in read-mode.
      18 votes
    8. What do you use for note taking/writing?

      I've been using Obsidian for notes for a year now and iA Writer for writing prose for a decade (wow!) and love both of them for their simplicity, cloud sync, and most importantly, their innate...

      I've been using Obsidian for notes for a year now and iA Writer for writing prose for a decade (wow!) and love both of them for their simplicity, cloud sync, and most importantly, their innate ability to get out of the way and let me work.

      But I'm always interested in other people's workflows! What do you use to write or take notes?

      44 votes
    9. How do you manage your digital notes?

      I am actually an Org Mode user, but I want something with great mobile support (Android) as well as desktop/web. None of the Org apps is good enough for me, and that may never happens. I don't...

      I am actually an Org Mode user, but I want something with great mobile support (Android) as well as desktop/web. None of the Org apps is good enough for me, and that may never happens. I don't even use my computer as much these days. I've been looking into Dynalist but the free version is bit too limited, the paid version is a bit much for me. Evernote is kinda the same. I could try Joplin+Dropbox? Obsidian? IDK. Any suggestions?

      22 votes
    10. Let's talk about taking notes

      I've been thinking about note-taking a lot recently. I'm not a particularly great note-taker myself, though I do use a calendar and a to-do list. My SO is a habitual digital note-taker, but also a...

      I've been thinking about note-taking a lot recently. I'm not a particularly great note-taker myself, though I do use a calendar and a to-do list. My SO is a habitual digital note-taker, but also a hand-written journaller too. I do neither of these things (and don't feel the worse for the lack), but I am curious about how my fellow tilderen feel towards notes in general, and journalling to a lesser extent.

      Are you a note-taker? If not, why not? If so, how does it add value to your life? Do you prefer a digital or a pen-and-paper notebook, or even a hybrid approach? And do you have a system?

      24 votes
    11. How do you all do "deep readings"?

      I'm reading a book right now that I am finding fascinating, but I don't want to forget the thoughts and ideas presented in each chapter by the end. I was wondering what you all do when reading...

      I'm reading a book right now that I am finding fascinating, but I don't want to forget the thoughts and ideas presented in each chapter by the end. I was wondering what you all do when reading books like this. In college, I would usually jot down a few notes on the chapter I was reading, but I always found the act of interrupting my reading to write to be very disruptive.

      • Do you take notes and highlight directly in the book, or use another notebook or software?
      • Do you take notes as you go, or wait until the end of a chapter or section?

      I want to arrive at a system that works well for me, so I'm looking for suggestions here.

      15 votes
    12. How do you people at universities handle your notes?

      Specially those of you who attend courses on the field of humanities, in which I feel the amount of note-taking is even greater than most fields, given all the reading and talking that occurs...

      Specially those of you who attend courses on the field of humanities, in which I feel the amount of note-taking is even greater than most fields, given all the reading and talking that occurs during classes and out of them. How do you do it? Do you write on paper perhaps, or do you find that digital notes suit you better?
      I'm asking this because I am about to start my studies (finally) and am curious about how other people handle this task which, honestly, has been a nuisance through all my life. I'm not the best at organizing my notes and I believe it harms my studying overall.

      16 votes
    13. Announcing the alpha release of Intergrid

      Intergrid is an online outliner and note-taking app. It's inspired by – and in many ways replicates – Indigrid, except it's on the Web. It's free to use, and it's readily available right from the...

      Intergrid is an online outliner and note-taking app. It's inspired by – and in many ways replicates – Indigrid, except it's on the Web. It's free to use, and it's readily available right from the main page.

      Why Intergrid?

      The main goal of Intergrid is to help you focus on the notes.

      There are no settings. You can't pick the font. Theming is not an option. There's only content, and what you want to do with it.

      Plus, it looks cool.

      Is it feature-complete?

      Hell no. It's been in development for three months – which is to say, not very long. It still has ways to go.

      Which is why I'm keeping the initial release rather quiet: Tildes and a handful of friends are the only people to know about it so far.

      Are there bugs?

      Afraid so. There are some I know about, and there are probably some I couldn't even reach.

      Why release it, then?

      Because it works already. You can add, edit, and save your notes in-browser. As long as you have cookies enabled, it will serve you. (Intergrid doesn't use cookies, and has no tracking to speak of, but the permission for localStorage – the technology used to store and gather data about your notes – is adjacent, as far as browsers are concerned.)

      It would be of particular use to people on systems other than Windows. While the current version is focused on desktops, future versions may gain mobile support – all the more likely because, outside from a handful of hardcoded interactions and design considerations, there's nothing preventing mobile users from enjoying the app.

      There's also the pragmatic reason: something Jeff Atwood called "Always Be Shipping", all the way back in 2007. You can't get feedback on an app that has no public version. Your programming expertise and design sense will only get you so far. Getting it out there – and going forward with the feedback – is a generous part of the process.

      Where are you planning to take it?

      The first step would be the fix the bugs. There will be a list of known ones in the comments.

      Once those are fixed (or can be postponed without repercussions to being able to use the app), there are features I'm going to implement within the next couple of months. Most of them, at least initially, are going to be put in to keep up with Indigrid's feature set.

      • Views: open, move, and close columns, each hosting a different view on the notes, allowing you to gain perspective or edit multiple ideas simulatenously

      • Bookmarks: store views as separate named bookmarks, allowing you to traverse different mental spaces within the notes

      • Action History and Undo/Redo: record changes to the notes and time-travel between its different states, because sometimes, you want to be able to "go there" and not be weighted down by rock-solid commitment

      • Offline Use: work with your notes even when the Internet is down

      (Even though the code for columns is already in the development branch, I was unable to come up with a respectable way of handling it before New Year, which is when I promised to release the app.)

      In the long term, I'd like to make sure you could access your notes from any browser on any device. This plan also includes the ability to create and share read-only or editable partial copies of your notes – for example, as presentation or a basis for an online discussion. After finishing with shaping up the current, local-only version, this is where want to take the development. I reckon it would take me somewhere between 6 and 12 months to finish the codebase for this.

      Anything else I should know?

      Do keep in mind that this is an early release. There may be bugs – perhaps even the kind that will rid you of your notes. If you're uncomfortable about using software this early in development, please don't: your sanity is dearer to me than getting users.

      It will, however, get stable over time. If there's ever a breaking change on the horizon – the kind of change that will change an aspect of Intergrid radically – users will be notified about it at least two weeks ahead, so that at least they could backup their notes. I want to ensure the safety of mind for the users of Intergrid, so that they know their notes are in safe hands.

      That said, make regular backups anyway. The nodes are encoded/decoded as indented plain text, which means they can be transferred to and from a simple textfile with copy/paste. Any single whitespace character – space, tab etc. – is considered one level of indentation, so it doesn't matter how you indent your plain-text notes: they will be aligned as you'd expect. Intergrid and Indigrid both export tab-indented text.

      Can I help?

      From the coding and design perspective, I would appreciate open-source involvement. However, at this stage, even though there's a repository awaiting changes, I'm uncomfortable making it public just yet, because licensing is hard and I don't want to get into any sort of legal trouble without at least understanding what I'm dealing with.

      Once this and other aspects of open-sourcing the code are dealt with, I'm going to post another update.

      If you'd like to support the development financially, you could donate via PayPal.me. The first $5 or so will go to supporting the infrastructure: the monthly hosting payment and 1/12th of the yearly domain name price. (Even though the domain name has been paid for for the next two years, I'd like to be able to host the app reliably. The domain name is directly tied to the data saved – you can't access another website's saved data unless they're on the same main domain – which is why it's important to keep it.)

      Check out Intergrid

      19 votes
    14. First release of my native Markdown notes app, Notementum (v0.1.0)

      Screenshot I posted a few days ago about a notes app I was working on called Notementum, and I'm happy to show you the first release (0.1.0). Installation instructions are available on the Github...

      Screenshot

      I posted a few days ago about a notes app I was working on called Notementum, and I'm happy to show you the first release (0.1.0). Installation instructions are available on the Github repo: https://github.com/IvanFon/notementum

      There's still lots of things I'd like to add, both big and small, and definitely a few bugs here and there, but I've been going for too long without sharing it, and I find it's best to release as early as you can to start getting feedback, and perfect it later.

      One things that's missing is documentation. I'd like to start on this soon, but I'm probably not going to share this anywhere other than Tildes just yet, so this comment will do for now :)

      Right now, the app only runs on Linux. I'd like to add Windows support, and it almost works, the problem is that WebKit2Gtk, the embedded web view I use to show note previews, doesn't support Windows. I'm going to explore some other options in the future, whether that's figuring out how to compile it, or allowing other preview methods (user's web browser, PDF, etc.).

      The app is also very much in alpha, so you shouldn't use this for anything important, there may be bugs that can cause you to lose some of your data. If you do use this for anything, make sure you backup your notes database.

      If you want to use it, here's a wall of text on usage:

      Usage

      The notes database is located at ~/.notes.db. When you launch the app, it'll load it, or automatically create it if it doesn't exist. I'd eventually like to allow choosing different locations, but it's hard coded for now.

      The interface is fairly simple. The leftmost sidebar displays a list of notebooks, and the "middlebar" displays a list of notes. Selecting a notebook will display the notes within it in the notes list. Selecting a note will open it in the editor, which is to the right.

      To create a new note, press Escape to focus on the searchbar above the notes list, and start typing a title. If no existing notes are found, press enter, and a note will be created with the title you entered.

      To rename a note, double-click on it in the notes list.

      The editor has a toolbar with 4 buttons, from left-to-right:

      • Toggle between editor and preview (shortcut: Ctrl+E)
      • Assign the current note's notebook
      • Add an attachment
      • Delete the current note

      The green circle all the way to the right turns into a loading indicator when you have unsaved changes. Once you stop typing for a few seconds, your changes will be saved, and it'll switch back into a green circle.

      Notebooks

      Notebooks aren't created directly, they're based on what notebooks your notes are assigned to. This means that, to create a notebook, assign it to a note. To delete a notebook, just delete all the notes contained within it, or assign them to a different notebook.

      Clicking on the notebook toolbar button brings up this dialog. To create a new notebook, double click on <New notebook> and type in a name.

      Attachments

      The notes database also stores attachments. This means that the entirety your notes can be contained in your database. Clicking on the attachment toolbar button brings up this dialog. The toolbar allows you to upload an attachment or delete it respectively. Pressing Insert Selected will insert the image at your cursor in the editor (![](image.png)).

      Theme

      The screenshots show the app with my desktop Gtk theme, Arc Dark. On your desktop, it'll use whatever your theme is. It should look good with any Gtk theme, but at some point I may bundle Arc Dark with it.

      The note preview currently has it's colours hard coded to look good with Arc Dark, so it may look a bit off on other themes. I'll try to sort that out at some point.

      Planned features
      • load/save database to/from different path
      • Windows support
      • note exports
      • database encryption
      • changing syntax highlighting theme
      • note tags
      • full-text search
      • proper documentation
      • more keyboard shortcuts
      • integrated sync
        • although you should already be able to use Git, Synthing, Dropbox, etc.
      • Vim mode for editor
        • maybe somehow embed a terminal to allow using vim/emacs/whatever
      Boring technical stuff

      The app was made with Python and Gtk+ 3. I've done this before and I really enjoy the development experience, especially with Glade to design the interface. There are still some Gtk features that I should really be using to make things simpler (GtkApplication, actions, and accelerators) that I'll be adding later.

      The database uses sqlite 3. This is convenient, as it allows for storing everything in one file, and will make fast searches easier in the future. Attachments are stored as base64 directly in the database. This makes it easy to have all your notes be contained entirely in the one database, but I may have to think about a more efficient method in the future.

      Markdown rendering is done using mistletoe, which has been great to use. Syntax highlighting and MathJax renderers were already available, so it was just a matter of combining both and adding custom image loading from the database, which was very easy. Mistletoe has a very easy to use API, so this was no problem.

      For LaTeX math rendering, I'm using MathJax. It supports pretty much everything, which is nice, but it can take a while to load. I'm currently loading it from a CDN in a <script> tag, so I'm hoping once I load it from a local file it'll be a bit faster. If not, I may have to find another solution.

      Like I said, the app still has a few bugs that need to be fixed. If you find any problems, it would be great if you could leave a comment here or open a Github issue (or if you have any feature requests).

      21 votes
    15. Online markdown editors that are capable of handling loads of text

      I have discovered hackmd.io a few months ago and started digitalizing my massive mess of handwritten nodes together with all the terrible notepad/word mixed notes into one big personal "wiki" of...

      I have discovered hackmd.io a few months ago and started digitalizing my massive mess of handwritten nodes together with all the terrible notepad/word mixed notes into one big personal "wiki" of knowledge. But I ran into a problem. HackMd can only handle ~50k characters before starting to lag and 100k characters is the limit per note, this doesn't even fit my one summary/tips note on one programming language. Do you know any alternatives? I really like markdown, since all of the notes look clean and organized, I can insert pictures and link to websites easily, but also love to work with them online, since I have to switch between 3 computers between university, home and my laptop.

      7 votes
    16. What is your note taking workflow?

      Hi, I'm wondering how and if you're taking notes and how you manage them. I feel like I can't get to the right solution. I want something open and own my data, so I tend to prefer plain text /...

      Hi,

      I'm wondering how and if you're taking notes and how you manage them. I feel like I can't get to the right solution. I want something open and own my data, so I tend to prefer plain text / markdown files and I want to manage them on my own for privacy reasons but still be able to sync and edit them on my mobile device (iOS), desktop (macOS) and ideally online and also have full text search.

      I know about Microsoft OneNote, Google Docs/Keep, Evernote - but I just can't overcome myself to use them since it's hard to impossible to get data out of there.

      Right now I'm hosting my own git repository with gitea.io and I'm able to edit my notes on the web, on my desktop (using git clone/pull/commit/push) and with a git client (working copy) on my phone. The downside: I need to manually commit and push my changes and also pull them, it's not really in sync.

      26 votes
    17. Note-taking, bookmarks, reminders and todos: What do you use to organize your life?

      I find myself on a bit of an unending quest to organize my own thoughts, especially since my work evolved into multiple streams on different projects. I have been looking for a tool to help me...

      I find myself on a bit of an unending quest to organize my own thoughts, especially since my work evolved into multiple streams on different projects.

      I have been looking for a tool to help me organize myself and focus on the things I want to do. More specifically, I keep wanting to improve my ability to remember things: Be able to remember faster, longer, recall more reliably, categorize, filter and export those things, etc.
      Links, reading material, "watch later" material, todo lists, contacts, phone numbers/emails, identities, what I know about people, reminders, highlights, emails to respond to, work logging, etc. The more I think about it, the more I have this need for a tool that essentially acts as a permanent second brain.

      I feel like I've tried everything. Note-taking apps like Keep, orgmode, wikis, journals, disorganized text files, issue trackers, Pocket, gmail itself, calendar reminders, even Magic. Nothing quite works. The issues I most consistently hit are:

      • The method is not good enough at ingesting abstract data. Examples: Anything calendar-bound is not good at storing anything that isn't related to a point in time. Pocket cannot store things that aren't links to web pages.
      • The method is far too cumbersome to be able to braindump into it or too impractical to retrieve data from. Examples: Wikis, Keep and other object-based note-taking systems are unfilterable unless you take a ton of time to attach a lot of metadata to each note. Magic is too asynchronous as you sometimes wait several minutes for responses (and it also gets far too expensive to use at the level I'd like).

      Despite trying everything, I don't know if I want to build that tool myself, because I think it probably already exists somewhere (and it might be down to me not knowing how to use the things that are already out there). Although if someone does feel inspired to build that, hit me up. :)

      My current flow looks like a frankenstein mix of Keep/Gmail/Calendar, which at least integrate with one another, and a ton of proprietary or dissociated methods (including Pocket, Discord, Spreadsheets/Drive, Magic, Kayak, 1Password and a ton of duplicate files and documents). Then it just becomes a matter of remembering what type of information is where, and how to best find it.

      So Tildes, what do you use?

      23 votes
    18. Need advice about Tomboy notes and note apps in general

      I'm looking for some advice on what note programs people recommend. Not a basic text editor, but something capable of doing some basic categorizing, chronological sorting, that sort of thing. I've...

      I'm looking for some advice on what note programs people recommend. Not a basic text editor, but something capable of doing some basic categorizing, chronological sorting, that sort of thing. I've used Evernote most recently, but I'm becoming less and less of a fan. I don't need cloud sync necessarily, although device sync could be handy. A pleasant UI (not fettered with extraneous crap) would be nice, but aesthetic appeal takes a backseat to navigation and stability. Target OS is mostly likely going to be windows 10.

      What are you experiences with note apps, what are your favorites?


      (A bit of context for anyone interested)
      Years ago, I used tomboy notes in Ubuntu for keeping track of timesheets/daily logs. It seemed like a good program to set up for my step dad to use as well. A few years later, Tomboy notes petered out without much fanfare. I've kept his laptop running with that setup for as long as I could, but the hardware is just getting worn out (it's about 10 years old now).

      So! Time to get him an upgrade. This time around, I don't think I'm gonna set up up with Linux. He isn't really up to the task of doing his own troubleshooting in linux (i.e. when an automatic update breaks something), and I haven't even been keeping up on Linux for the past few years myself. So I'm probably going to set him up on a Windows machine.

      I should be able to export the tomboy notes database fairly easy, but it would be a huge load off my mind if I could settle on a decent program to migrate to first.

      Thanks in advance for any input!

      11 votes
    19. Alternatives to Markdown for writing short documentation/TODOs?

      Hi guys, I often find myself writing small text files for projects, like a bit of documentation or TODOs. I have a proper system in place for larger projects, but would love to be able to scribble...

      Hi guys,

      I often find myself writing small text files for projects, like a bit of documentation or TODOs. I have a proper system in place for larger projects, but would love to be able to scribble down things for larger ones.

      As big of a fan of Markdown as I am, I find that it's often inappropriate for these kinds of tasks. For example, I find myself mimicking a task list with multiple-paragraph list items.

      What do you guys use? Do you know of any Markdown alternatives that give you a bit more control over the layout?

      Thanks!

      14 votes
    20. My random notes for Nim lang

      -> Nim notes <- Some background I am learning a new programming language Nim. As many would do, I also take my own notes as I am learning it, running little example by myself, etc. .. but I doing...

      -> Nim notes <-


      Some background

      I am learning a new programming language Nim. As many would do, I also take my own notes as I am learning it, running little example by myself, etc.

          .. but I doing that a bit differently.

      • I take notes in Emacs Org mode. Org mode has a feature set called Org Babel. That allows one to document the code snippets, and also run them directly in that document, and insert their output results below them -- Notes in Org

        This also helps me document regression of the language behavior between different Nim versions of any, as the exact outputs are documented too. After each major Nim update, I press a single binding (C-v C-v b) in Emacs, and all the output blocks get recalculated.

      • But not everyone uses Emacs and Org mode. So to be able to share them to a wider audience, I need to export (Org term) that to a format like HTML, PDF, or Markdown..

      • Hugo is a really fast static site generator that uses Markdown as one of the primary content formats. It parses that to HTML using a Go Markdown library called Blackfriday.

      • As my notes are in Org mode, and converting them to HTML via Hugo needs them to be in Blackfriday compatible Markdown (which is almost like GitHub flavored Markdown), I starting working on an Emacs Org mode package ox-hugo about a year back. Using that, this Markdown file is generated. Hugo natively supports a subset of Org, but I needed to write this package to use the full power of Org mode.

      • Hugo then takes that Markdown and generates the final Nim notes page in HTML.


      In the end, I have something that ties together all things of my interest: Nim, Emacs, Org mode and Hugo :)

      8 votes