All notable changes to the "foam-vscode" extension will be documented in this file.
Check Keep a Changelog for recommendations on how to structure this file.
Fixes and Improvements:
- Modifies url encoding to target only the filename and skip spaces (#1322 - thanks @MABruni)
- Minor tweak to quick action menu with suggestions for section name
Fixes and Improvements:
- Fixed wikilink definition encoding (#1311 - thanks @MABruni)
Fixes and Improvements:
- Using note title in preview (#1309)
Fixes and Improvements:
- Added support for linking sections within same document (#1289)
- Fixed note embedding bug (#1286 - thanks @badsketch)
Fixes and Improvements:
- Fixed incorrect handling of embedding of non-existing notes (#1283 - thanks @badsketch)
- Introduced Note Embedding Sytanx (#1281 - thanks @badsketch)
- Attachments are not considered when computing orphan notes (#1242)
Fixes and Improvements:
- Added content-only embed styles (#1279 - thanks @badsketch)
- Added expand-all button to tree views (#1276)
Fixes and Improvements:
- Added support for path parameter in filter (#1250)
- Added grouping and filtering to tag explorer (#1275)
- Added new setting to control note embedding (#1273 - thanks @badsketch)
- Added last week's days to snippets (#1248 - thanks @jimgraham)
Internal:
- Updated jest to v29 (#1271 - thanks @nicholas-l)
- Improved test cleanup and management (#1274)
Features:
- Support for multiple extensions and custom default extension (#1235)
- Added
FOAM_TITLE_SAFE
template variable (#1232)
Fixes and Improvements:
- Connections panel tweaks (#1233)
Features:
- Converted backlinks panel into more general connections panel (#1230)
Internal:
- Improved janitor code (#1228)
- Refactored code related to tree view panels (#1226)
- Lint and cleanup (#1224)
Features:
- Added notes explorer (#1223)
Fixes and Improvements:
- Enabled tag completion in front matter (#1191 - thanks @jimgraham)
- Various improvements to tree views (#1220)
Fixes and Improvements:
- Support to show placeholders only for open file in panel (#1201, #988)
- Show note block in panels on hover preview (#1201, #800)
- Show tag references within tag explorer (#1201)
- Improved structure of view related commands (#1201)
- Ignore
.foam
directory
Fixes and Improvements:
- Allow the
#
char to trigger tag autocompletion (#1192, #1189 - thanks @jimgraham)
Fixes and Improvements:
- Added support for deep tag hierarchy in Tag Explorer panel (#1134, #1194)
- Consolidated and improved Backlinks, Placeholders and Orphans panels (#1196)
- Fixed note resolution when using template without defined path (#1197)
Fixes and Improvements:
- Fixed issue with generated daily note template due to path escape (#1188, #1190)
Fixes and Improvements:
- Fixed relative path from workspace root in templates (#1188)
Fixes and Improvements:
- Fixed embed with relative paths (#1168, #1170)
- Improved multi-root folder support for daily notes (#1126, #1175)
- Improved use of tag completion (#1183 - thanks @jimgraham)
- Fixed relative path use in note creation when using templates (#1170)
Internal:
- Sync user docs with foam-template docs (#1180 - thanks @infogulch)
Fixes and Improvements:
- Fixed note creation from placeholder (#1172)
Features:
- Added support for filters for the
foam-vscode.open-resource
command (#1161)
Internal:
- Updated most dependencies (#1160)
Fixes and Improvements:
- Inform the user that directory renaming is not supported (#1143)
- Fixed extra
web
directory in published extension (#1152 - thanks @piousdeer)
Fixes and Improvements:
- Updated minimum VS Code version to 1.70.0 (#1140)
- Fixed preview links with sections (#1135 - thanks @badsketch)
- Added setting for creating new notes in root or current dir (#1142)
Fixes and Improvements:
- Fixed entry count in orphan, placeholder, tags-explorer panels (#1131 - thanks @badsketch)
Fixes and Improvements:
- Added support for emoji tags (#1125 - thanks @badsketch)
Fixes and Improvements:
- Show number of entries in title for orphan, placeholder, tag treeviews
Fixes and Improvements:
- Creating new note uses default template when none is provided (#1094)
Internal:
- Changed matcher implementation to remove dependency on micromatch/glob
- Removed unnecessary dependencies and assets from extension
Fixes and Improvements:
- Improved support for daily notes in multi root workspace (#1073)
- Create note from placeholder using template (#1061 - thanks @Dominic-DallOsto)
- Improved support for globs in multi root workspace (#1083)
Features:
- Added
foam-vscode.create-note
command, which can be very customized for several use cases (#1076)
Fixes and Improvements:
- Removed
+
as a trigger char for date snippets - Improved attachment support (#915)
- Improved error handling when starting Foam without an open workspace (#908)
- Added support for opening non-text files via wikilink (#915)
- Dataviz: now clicking is enough to open a link from the graph
- Dataviz: clicking on images/attachments will open them
Fixes and Improvements:
- Added
FOAM_DATE_WEEK
variable (#1053 - Thanks @dmurph) - Fixed extension inclusion when generating references for attachments
- Link completion label can be note title as well as path (#1059)
- Images and attachments are not shown by default in graph view (#1056)
Fixes and Improvements:
- Fixed note embed in preview (#1052)
Fixes and Improvements:
- Image embeds fixed in preview (#1036)
Fixes and Improvements:
- Added support for angle markdown links (#1044)
- Filter out invalid file name chars when creating note (#1042)
Internal:
- Reorganized docs (#1031, thanks @infogulch)
- Fixed documentation links (#1046)
- Preview code refactoring
Internal:
- Introduced cache for markdown parser (#1030)
- Various code refactorings
Features:
- Support for attachments (PDF) and images (#1027)
- Support for opening day notes for other days as well (#1026, thanks @alper)
Fixes and Improvements:
- Support for
alias
YAML property to define note alias (#1014 - thanks @lingyv-li)
Internal:
- Improved extension bundling (#1015 - thanks @lingyv-li)
- Use
vscode.workspace.fs
instead offs
(#1005 - thanks @joshdover)
Fixes and Improvements:
- move past
]]
when writing wikilinks (#998 - thanks @Lauviah0622) - highlight improvements (#890 - thanks @memeplex)
Fixes and Improvements:
- Better reporting when links fail to resolve
- Failing link resolution during graph computation no longer fatal
Fixes and Improvements:
- Fixed parsing error on empty direct links (#980 - thanks @chrisUsick)
- Improved rendering in preview of wikilinks that have link definitions (#979 - thanks @josephdecock)
- Restored handling of section-only wikilinks (#981)
Fixes and Improvements:
- Fixed parsing error for direct links with square brackets in them (#977)
- Improved markdown direct link resolution (#972)
- Improved templates support for custom paths (#970)
Features:
- Link synchronization on file rename
Internal:
- Changed graph computation on workspace change to simplify code
Fixes and Improvements:
- Do not add ignored files to Foam upon change (#480)
- Restore full use of editor.action.openLink (#693)
- Minor performance improvements
Fixes and Improvements:
- Include links with sections in backlinks (#895)
- Improved navigation when document editor is already open
Fixes and Improvements:
- Don't fail on error when scannig workspace (#943 - thanks @develmusa)
Fixes and Improvements:
- Added FOAM_SLUG template variable (#865 - Thanks @techCarpenter)
Fixes and Improvements:
- Improvements to Foam variables in templates (#882 - thanks @movermeyer)
- Foam variables can now be used just any other VS Code variables, including in combination with placeholders and transformers
Fixes and Improvements:
- Fixed autocompletion with tags (#885 - thanks @memeplex)
- Improved "Open Daily Note" to be usabled in tasks (#897 - thanks @MCluck90)
Fixes and Improvements:
- Improved support for wikilinks in titles (#878)
- Use syntax injection for wikilinks (#876 - thanks @memeplex)
- Fix when applying text edits in last line
Internal:
- DX: Clean up of testing setup (#881 - thanks @memeplex)
Fixes and Improvements:
- Decorate markdown files only (#857)
- Fix template placeholders issue (#859)
- Improved replacement range for link completion
Internal:
- Major URI/path handling refactoring (#858 - thanks @memeplex)
Features:
- Added first class support for sections (#856)
- Sections can be referred to in wikilinks
- Sections can be embedded
- Autocompletion for sections
- Diagnostic for sections
- Embed sections
Fixes and Improvements:
- Fixed diagnostic bug triggered when file had same suffix (#851)
Features:
- Added support for unique wikilink identifiers (#841)
- This change allows files that have the same name to be uniquely referenced as wikilinks
- BREAKING CHANGE: wikilinks to attachments must now include the extension
- Added diagnostics for ambiguous wikilinks, with quick fixes available (#844)
- Added support for unique wikilinks in autocompletion (#845)
Fixes and Improvements:
- Fixed filepath retrieval when creating note from template (#843)
Fixes and Improvements:
- Re-enable link navigation for wikilinks (#840)
Fixes and Improvements:
- Fixed template listing (#831)
- Fixed note creation from template (#834)
Fixes and Improvements:
- Link Reference Generation is now OFF by default
- Fixed preview navigation (#830)
Fixes and Improvements:
- Major improvement in navigation. Use link definitions and link references (#821)
- Fixed bug showing in hover reference the same more than once when it had multiple links to another (#822)
Internal:
- Foam URI refactoring (#820)
- Template service refactoring (#825)
Fixes and Improvements:
- Detached Foam URI from VS Code URI. This should improve several path related issues in Windows. Given how core this change is, the release is just about this refactoring to easily detect possible side effects.
Fixes and Improvements:
- Avoid delaying decorations on editor switch (#811 - thanks @memeplex)
- Fix preview issue when embedding a note and using reference definitions (#808 - thanks @pderaaij)
Features:
- Added
FOAM_DATE_*
template variables (#781)
Fixes and Improvements:
- Dataviz: apply note type color to filter item label
- Dataviz: optimized rendering of graph to reduce load on CPU (#795)
- Preview: improved tag highlight in preview (#785 - thanks @pderaaij)
- Better handling of link reference definition (#786 - thanks @pderaaij)
- Link decorations are now enabled by default (can be turned off in settings)
Fixes and Improvements:
- Improved filtering controls for graph (#782)
- Link Hover: Include other connected notes to link target
Features:
- Preview on hover for wikilinks (#728 - thanks @JonasSprenger)
- Added tags and controls to graph dataviz (#737 - thanks @dannysemi)
Fixes and Improvements:
- Improved tags parsing (#708 - thanks @pderaaij)
- Fixed support for resources named like JS Object methods (#729 - thanks @JonasSprenger)
Features:
- Autocompletion for tags (#708 - thanks @pderaaij)
- Use templates for new note created from wikilink (#712 - thanks @movermeyer)
Fixes and Improvements:
- Improved performance of initial file loading (#730 - thanks @pderaaij)
Fixes and Improvements:
- Fixed NPE that would cause markdown preview to render incorrectly (#718 - thanks @pderaaij)
Features:
- Create new note from selection (#666 - thanks @pderaaij)
- Use templates for daily notes (#700 - thanks @movermeyer)
Fixes and Improvements:
- Fixed for wikilink aliases in tables (#697 - thanks @pderaaij)
- Fixed link definition generation in presence of aliased wikilinks (#698 - thanks @pderaaij)
- Fixed template insertion of selected text (#701 - thanks @movermeyer)
- Fixed preview navigation (#710 - thanks @pderaaij)
Fixes and Improvements:
- Improved handling of capitalization in wikilinks (#688 - thanks @pderaaij)
- This update will make wikilinks with different capitalization, such as
[[wikilink]]
and[[WikiLink]]
point to the same file. Please note that means that files that only differ in capitalization across the workspace would now be treated as having the same name
- This update will make wikilinks with different capitalization, such as
- Allow dots in wikilinks (#689 - thanks @pderaaij)
- Fixed a bug in the expansion of date snippets (thanks @syndenham-chorea)
- Added support for wikilink alias syntax, like
[[wikilink|label]]
(#689 - thanks @pderaaij)
Fixes and Improvements:
- Fixed #667, incorrect resolution of foam-core library
Internal:
- BREAKING CHANGE: Removed Foam local plugins If you were previously using the alpha feature of Foam local plugins you will soon be able to migrate the functionality to the V1 API
Fixes and Improvements:
- Fixed #667, incorrect resolution of foam-core library
Fixes and Improvements:
- Improved support for nested tags (#661 - thanks @pderaaij)
- Allow YAML metadata in templates (#655 - thanks @movermeyer)
- Fixed template exclusion globs (#665)
Fixes and Improvements:
- Added support for nested tags (#643 - thanks @pderaaij)
- Improved the flow of creating note from template (#645 - thanks @movermeyer)
- Fixed handling of title property in YAML (#647 - thanks @pderaaij and #546)
Internal:
- Updated various dependencies
Fixes and Improvements:
- Improved Foam template variables resolution: unknown variables are now ignored (#622 - thanks @movermeyer)
- Fixed file matching in MarkdownProvider (#617)
- Fixed cancelling
Foam: Create New Note
andFoam: Create New Note From Template
behavior (#623 - thanks @movermeyer)
Fixes and Improvements:
- Fixed wikilink completion bug (#592 - thanks @RobinKing)
- Added support for stylable tags (#598 - thanks @Barabazs)
- Added "Create new note" command (#601 - thanks @movermeyer)
- Fixed navigation from placeholder and orphan panel (#600)
Internal:
- Refactored data model representation of resources:
Resource
(#593)
Fixes and Improvements:
- fixed bug in Windows when running
Open Daily Note
command (#591 - Thanks @RobinKing)
Features:
- Wikilink completion (#554)
Fixes and Improvements:
- fixed link navigation on path with spaces (#542)
- support for Chinese characters in tags (#567 - thanks @RobinKing)
- added support for
FOAM_TITLE
in templates (#549 - thanks @movermeyer) - added configuration to enable/disable link navigation (#584)
Fixes and Improvements:
- Link decorations are now optional (#558)
- Improved UX when creating notes from templates (#550 - thanks @movermeyer)
Features:
- Launch daily note on startup (#501 - thanks @ingalles)
- Allow absolute directory in daily notes (#482 - thanks @movermeyer)
- Navigate wikilinks in Preview even without link definitions (#521)
- Workspace navigation (links and wikilinks) powered by Foam (#524)
Fixes and Improvements:
- Ignore directories that have .md extension (#533 - thanks @movermeyer)
Features:
- Placeholders Panel: quickly see which placeholders and empty notes are in the workspace (#493 - thanks @joeltjames)
- Backlinks panel: now a Foam model powered backlinks panel (#514)
Fixes and Improvements:
- Dataviz: fixed graph node highlighting (#516, #517)
Fixes and Improvements:
- Model: fixed wikilink resolution when using link definitions
- Templates: improved validation during template creation
Fixes and Improvements:
- Templates: improved the flow of creating a new note from a template
Fixes and Improvements:
- Model: fixed consolidation of model after change events
- Dataviz: improved consolidation of graph
Features:
- Notes preview in panels (#468 - thanks @leonhfr)
- Added more style options to graph setting (lineColor, lineWidth, particleWidth (#479 - thanks @nitwit-se)
Internal:
- Refactored data model representation of notes graph:
FoamWorkspace
(#467)
Fixes and Improvements:
- Panel: Updating orphan panel when adding and removing notes (#464 - thanks @leonhfr)
Features:
- Panel: Added orphan panel (#457 - thanks @leonhfr)
Features:
- Model: Now direct links are included in the Foam model (#433)
- Commaands: Added
Open random note
command (#440 - thanks @MCluck90) - Dataviz: Added graph style override from VsCode theme (#438 - thanks @jmg-duarte)
- Dataviz: Added graph style customization based on note type (#449)
Fixes and Improvements:
- Various improvements and fixes in documentation (thanks @anglinb, @themaxdavitt, @elswork)
Fixes and Improvements:
- Fixed word-based-suggestions (#415 #417 - thanks @bpugh!)
- Date snippets use standard wikilink syntax (#416 - thanks @MCluck90!)
Fixes and Improvements:
- Fixed "Janitor" command issue in Windows (#410)
Fixes and Improvements:
- Fixed "Open Daily Note" command issue in Windows (#407)
Fixes and Improvements:
- Fixed a bug that was causing Foam to not work correctly in Windows (#391)
Fixes and Improvements:
- Foam model: fix to link references on node update/deletion (#393 - thanks @AndrewNatoli)
- Dataviz: fix hover/selection (#401)
- Dataviz: improved logging
- Dataviz: style tweaks for better readability
Fixes and Improvements:
- Dataviz: Sync note deletion
- Foam model: Fix to wikilink format (#386 - thanks @SanketDG)
Features:
- Foam logging can now be inspected in VsCode Output panel (#377)
Fixes and Improvements:
- Foam model: Fixed bug in tags parsing (#382)
- Dataviz: Graph canvas now resizes with window (#383, #375)
- Dataviz: Limit label length for placeholder nodes (#381)
Features:
- Foam stays in sync with changes in notes
- Dataviz: Added multiple selection in graph (shift+click on node)
Fixes and Improvements:
- Dataviz: Graph uses VSCode theme colors
- Reporting: Errors occurring during foam bootstrap are now reported for easier debugging
Features:
- Added command to create notes from templates (#115 - Thanks @ingalless)
Fixes and Improvements:
- Foam model: Fixed bug that prevented wikilinks from being slugified (#323 - thanks @SanketDG)
- Editor: Improvements in defaults for ignored files setting (thanks @jmg-duarte)
- Dataviz: Centering of the graph on note displayed in active editor (#319)
- Dataviz: Improved graph styling
- Dataviz: Added setting to cap the length of labels in the graph (thanks @jmg-duarte)
- Misc: Fixed problem with packaging icon in extension (#350 - thanks @litanlitudan)
Features:
- Added tags panel (#311)
Fixes and Improvements:
- Date snippets now support configurable completion actions (#307 - thanks @ingalless)
- Graph now show note titles when zooming in (#310)
- New
foam.files.ignore
setting to exclude globs from being processed by Foam (#304 - thanks @jmg-duarte) - Errors in YAML parsing no longer causes foam to crash (#320)
- Fixed error in CLI command janitor & migrate (#312 - thanks @hikerpig)
Features:
- Added
Foam: Show Graph
command - Added date snippets (/+1d, ...) to create wikilinks to dates in daily note format
- Added
Foam: Copy to Clipboard without brackets
command
Improvements:
- Added new option to not generate wikilink definitions
foam.edit.linkReferenceDefinitions
:off
Bug Fixes:
- Daily note could be created before the daily note directory (#232)
- Fix issue with janitor crashing when file is only frontmatter (#222)
- Fix link references spacing when there is no trailing newline (#236)
New experimental features:
- Introduced foam local plugins
Fixes and improvements:
- Fix Daily Notes command on Windows.
Features:
- Daily Notes
- Janitor for updating headings and link references across your workspace
Fixes and improvements:
- Configuration setting for generating link reference definitions with file extension to support standard markdown tools, such as GitHub web UI
- Improvements to how new notes are indexed
Improvements:
- Order link references alphabetically to cause smaller diffs
- Remove link references when links are removed
- Documentation improvements
Underneath, everything has changed:
- Published from Foam monorepo
- Rewrote markdown parsing to use unifiedjs AST
- Rewrote workspace index to user graphlib graph data structures
These changes will enable to make more robust and ambitious releases more frequently 🎉
- Support paths to files in subdirectories
- Add support for VS Code 1.45.1
- Fix flaky reference block replacement logic that would occasionally leave trailing fragments in the end of the document (#3)
- Include Getting Started instructions
- Update extension name.
- Fix markdown link format (
link.md
to justlink
).
- Initial release